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le. general Infornation 


leis Introduction. 


The Mark Yeu software release includes a numoer of rew oregram 
products and major  e2nhancenents» descrided in detail tn the 
following sections of this releas2 document. 


References to the 81:06 series includ2 the Bl19°2» 818% and 21743 
SystemsSe 


Starting with the Mark $e: rsteaase of the 2176¢ System Softwares 
the release tevel nundDers 2re iin I2G int Instead of. noman 


numeral. This increases readacilty and compatioility witn other 
sou: program product releases. 


The SYSTEM NUTES are divided into two documents» SYSNOTEL and 


SYSNUTE2 SYSNOTEL contains alt of tne-new anhancements and any 
Soapoeey aqocunentation for the software release. SYSNOTEL 
consists of a4 general section and a section for each orogran 
product. A table of contents is orevided to determine the 
section numder in which a program product is documertede © Each 
section has an Introduction subsection and optionally an 


Enhancement subsection and a Temporary Documentation sudsection 
numbered i» 2» and 3 respectivelye The sudsection nugser follows 
the section number with a ceriod between thems  #$Paragraohs are 
numbered in ascending order within a subsection. The paragraph 
number follows the subsection numoer with a cericd oetween then. 
SYSNOTE2 contains ali of the known errors and restrictions Listed 
in alphabetic order oy Style ID and program name. | 


~Bbisk file headers. have changed for the Mark 9.08 release. Mark 
Jed MCP allows a Mark 7e¢ user pack to Fe readied urder Mark 9.3% 
the MCP converts all Mark fe: disk file headers te the Mark 9.¢ 
formate. When changing the systen software from Mark 9.5 to Mark 
?eG» all user packs must first be readied on the Mark 3209 release 
of the MCP» as the Mark 7.0 “CP is not able to convert Mark 9.¢ 
disk file headers. No code file executed under.the Mark 2.6 
system software can be exected under any prior release of the 
systen software. No system utility orogram from ocrior releases 
of the system software can 52 executed sucessfully uncer the Mark 
Ge software. the 
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Enhancements. 


new program oroducts are availavle with the Mark 9.2% 


release of the system softwares: 
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The ANST 74 CO3OL CCULIL74) compiler orcgramt creduct. 
The ANSI 77 FORTRAN CFURTRAN77) compiler orcgran product. 
The Interactive sasic CISASIC) compiler ecregram oreduct 


scheduled for release approxitatealy one quarter after the 
initial release of the Mark Ye. System software 


The Mark 9.2 release also provides many inoortart new functional 
capadilities and enhancements- The following saragraphs list 
some of the new features in this rekeasee a | 
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Major changes have deen mada tao the Sol and RPG 


interoreters to increase their oerformarce. 


New file attrioutes have neen added and arse avaitabdte 
through the “FILE"™ equation control command. 


The mechanisa for writing te a printer file has deen 


Changed in the MMCP to sneed up the gprecess dy creating 


fewer physical writes to the crinter and te accommodate 
ANSI 74 COBOL hequarewe nt ss: | . 4 


The output of the "CU" command nas Deen @nharced to more 
completely indicate the allocation of system menory 
and/or program memorye : 


The sa i command 15 ne donger used ta execute 
SYSTEH/LUADeCAS. jjThe "LC”™ command now allcws a2 comment 


to ode entered in the system Loge SYSTEM/LUAD.CAS must 
now de executed explicitly. | ae 


The *WS” command now allows syntax to query the status of 
either the active scnedulie or the WAITING schedule» or 


The MCP now accepts more than two operator. commands © In oa 
Single input string. 


The MCP now atlows 3 new disk file accessina method named 
"RELATIVE". | en - 


The "SO" message may now he used to specify additional 


system drives which are on different charnets than the 
original system disks» as tong as ne tue of these system 


disks are on (the same unit number. : 


Up to 32 spindles ag disk car now be. on tire at the Same 


tine. 


lle For the Mark 9.0 ralease of the &P3 compiler» the "*ALL* 
entry has been implemented» making the coding of RPG"OMS 
programs easiere 


12- A program can now open a remote file with 

"SEMPLE ADERS™ which provides the capabilities of. a 
"HEADERS®™ file without the responsibilities cf a Massage 
Control system CCS). 


l3Se in the Yark 9e. release of NUL» an MCS nay now request 
that the LSN for 2 station Seine detached from 3 remote 
file oe detached from the File Information Bleck CFId) of 

the remote file CCETACH with CLEAR). 

CO ee ne aateieneneneal 


—1l4e Two new PNUL/LIBRARY” files "COCSOLT40EC” and 
"CUSUL74SEL%» have been added to permit CO&SL74 orograms 
to issue a “SEND" with advancing feature (for CxT devices 


onlyJe 
New "MCS" control messajes have seen added for the Mark 
G9eG release of NDL to accomodate ANSI 74 COBOL 


requirements. 


15< Program switch numder 5 of CANDE now determines whether 
CANDE ts to run with file security. 


16. For users of CANDE» a family name and a packtid can now 
be specified for an output file if the user is iogged on 
to CANDE with a privileged usercode/password. 


17-2 Two new file types hav2 been added to the CANCE orogram: 
COsOL74 and FORTRAN?7~. 


la. The SYCOM program now allows OMS files to o¢€ transfered. 


19- The format of the “"Ju3S" file in the S4C3 pregram was 
changed to allow a user to soecify 4a pregrartid in the 
"SIGN ON» "PASS™» or “STAKT" command to differ from the 
program name zip executed by SMCS as a result of the 
"SIGN ON"™» "PASS"» or "START™ commande In additions the 
flags for the varicus program attridutes have been 
Siaplified. 


2Ge The HASP program now allows 4a three~character renote 10D 
fretd in the HASP/PARAMETERS file. 


2ie PACK/INIT and SYSTEM/DISKeINIT now altow initialization 
of a single cylinder of a pack» without disturbing other 
data on the pack»  $providing the entire cylinder is 
available. _ 


220 The new program CnAEATE/TASLE provides the aoility to 
| create user-specified transtate taoles. | : 


232 The ability. to print “JANNERS" has o2gen added to 
SYSTEM/BACKUP. | | 


24-2 The "COMPARE" functicn of the SYSTcM/COPY orccram can now 
be used independently of the "COPY" functione 


Z25e@ The print fields in the "TASS/SUM"™ orcarar have oegen 
increasea to four digits» allowing a figure creater than 
$99 hourse 


26« LOSGCONVERT now retains the parent joo number when a joo 
is spawned. 


Many of the items Listed within the Ennancemnent subsections are 
fixes to prodlems reported in SYSNUTE2 for tne Mark &-} releases. 
These items are indicated oy the FTIR numder that resorted the 
oprobiem surrounded Dy parentheses. 


System Flashes provide a wnethod cf rapid dissemination of 
pertinent information in regard to progran productse The text of 
a System Flash 1s as complete and concise as possidle. The main 
purpose of a Flash is to expedite information abcut software 
problems that require inmediate attentions 


The flash number tncludes the release tevel to which the flash 
applies and when a new release of software is issued» att 
previous flashes are» in effects cancelled. If the proolems 
described by flashes. to prior releases continue to apply» 
decumentation regarding thes2 problems will contained to be 
etther in the permanent documentations the release documentations 
or reissued as a flash with a new number. 


le3e22 Field Trouble Report (form 1912023). 


The standard form for reporting 31503 systema software oroblems is 
the Field Trouble Report (FTA). This 18 a stngle rfrace»y sixcopy 
fors which provides TIG with information to precess the report 
and resoive the problem Deing reported. , 


The following information and guidelines have DdDeen inctuded in 
the System Notes in order that every one invoived with the FTIR 
process has. a better understanding of the oprecedure and 
requirements when filling out an FTIR. 


When a problem is encountered in a customer installation it 
should be reported to the local Surroughs representative. If the 
probiem cannot be solved at a Local teavelt an FTIR shoautd be filled 
out by the tocal Burroughs representative and forwarded to TI0> 


through the District office» or through Sudsidiary Head Offices 
in the International Group. 


The tlocat personnel who fill out FIR*s must be certain that the 
FIR tS accompanied by all of the necessary supoorting 
documentation or medias, | | 


then TIO receives the FT» Tid acknowledges receipt of an FIR by 
mait within one working day and then conducts a thoroush 


investigation to deterasmine the extent of the probleme If the 
problem does not require a scftware change» TiC answers the FITR 
and returns the answer to the originator through the 
District/Sudsidiary Uffice. if the proodlen requires software 
changes» the FIR 18 sent tc the otant for correcticne When the 
correction 15 made» the olant sends the answer to TI9 and TIO 


forwards the answer to the criginator through the 
District/Sudsidiary Office. | 


The following guidelines must be followed when suomitting FIR%s: 
A separate FIR for each croblem. 
Use FIR form €41912¢033). 


Use the FIR for reperting system software provlerss not for 
requesting new features» reporting documerntaticn errors» or 
asking questions. 


Make it lLegibte on all copies» preferably typewritten. 


Ensure that all attachments are Labeled with the FTR nusber 
and are listed on the FIR forme 


There are specific instructions that must be. followed when 
completing thea Fir forme These instructions are listed an the 
back of the tast copy Coriginator’s copy) of the FIae form. 


Attachments to an FTIR: 


The FTR should inctude any information that may help solve the. 
problem. Some attachments that should always be censidered for 
inclusion are: 


A full memory dump that has been properly analyzed dy 
MCPII/ANALYZER- ALlt questions on the face of the dunp must 
be a@nswered and registers requested filled in if not done by. 
the analyzer... | | 


A programs dump» if applicabdie. 


A program trace file Listing» if aoplicables such as a 

DC/AUDIT tisting for data communicaticns progranss an 
 SMCS/TRACE file listing for the SCS program» or a. 

CANDE/SANALYZER Listing for the CANCE program. es : 


A copy of the SPU log entries for the pertinent time pertod. 
A code tisting of the erroneous compiler cut puts 

A source Listing of user programs involved in the eee 
Source and object files on machire readable media. 


Chservations dy site cersonnel that are pertinent to the 
problem. 


Any notes» information» and comments oy the person analyzing 
the proodlem. 


Each attachnent to the FTR must de tabelec with the FTR 
number e- | 


Return of Inctuded Media 


Machine readadte media is returned if requestede Each item to De 
returned must be tatbeled witn the return address. 


Data Management Problems 


Additional information may ode required for data management 
probleas. The following itens should be cansidered for ONSITI 
FIRS: 3 : | 


A small machine readable test cas2. 
A machine readadle copy of the DASCL source file and any 
applicable AUDIT files. 

it may be necessary toa have the local gurroughs 
representative run special debug traces cf the database and 
include them with the FTA. 


Memory Dumps. 


Both the program dump and full system dumps are vatuabdte. 
Program dumps are useful when the proolem is restricted to the 


program environment. Gtherwise send a full system dunpe CWhen 
in doubt» send a full system dump along with the program dump). 


223232 Memory Requirements. 


Burroughs has consistently continued to Imelement rew software 
features for the 310U3» most of which have been at the request. of 
our userse | | an 


Although every effort has been made to implement such features 
without an accompanying increase in system resource requirements» 
notably memory» it is becoming increasingly apparent that this is 


not possidle without seriously tmoacting the inplererntation and 
efficiency of such new featurese 


The effects» on userses of such increases tn resources vari2s from 
release to release and from user to usere in general» the MEP %s 
minimun permanent resident space has continued to trcrease each 
releasee Non"permanent space requirements Ceege Space recauired 
for temporary tasks such as openini/sclosing a file» $005 EGU 
etce) also continue to increase each releases Sy varying amount 5p. 
as more efficient structures are implementa2d. 


A possible decrease in efficiency from reitease to releas2? ts not 


necessarily a function of the system's memory 312€» but rather 
the efficiency with whicn that space is utitized.e An 
installation which is not tnrashinas and rot even close to 
thrashing» will most tiketly not exanerverce ary decrease in 


efficienty when imolenenting a new release. Cn the cantrarys» it 
is most iikety that system performance witl improves due to new 
featuras» more efficiency structuress etc. 


Gn the other hands» an installation which is alreacy thrashing» 
will probaoly notice a detericratior in throughput ranging fron 
mild {a few percent) to such severity that run times could 
approach infinity. An installation which was rot thrashing on a 
previous release (but was dangerously close) might recuirer» with 
the new releases an increase in memory sufficient to cause 
thrashing. for tne first time. Once agains the severity of 
thrashing depends on how close the installation was to thrashing 
prior to instatlation of the new releases 


If it is suspected that thrashing is occurring» or may occurs 
Burroughs strongty recommends analysis of possidle tmpact on the 
System's performances before installing the new releasee 


The following is a comparison of memory requirements for the last 
three releases of software for the 31% 26. 


31860 MEMORY REQUIREMENTS 


STATIC SYSTEM SPACE 


MMCP 


TOTAL SYSTEM SPACE 


RPG program +t INTERPRETER 


@186u/RPG program THRASHING PCiNT 


d17l4 MEMORY REQUTREMENTS 


STATIC SYSTEM SPACE 
LESS 31960 COCE 


B1714 STATIC SYSTEM SPACE 


MMCP 


TOTAL SYSTEM SPACE 


RPG program + INTERPRETER 


B1714/RPG program THRASHING PC1 


‘fark 


438 31 


mamas @ =. 


Mark 
3 ek 


235530 
1754 


21551 


2525 


25117 


1a7 32 


43Ze13 


deSehe SOftware included with the Mack 92. Aeleases 
The following iist details the software that is available as part 
of this releasee Programs preceded oy an asterisk are odetng 
released for the first time on Mark ye. 
Program Identification Version Compile date Remarks 
AUCIT/ANALYZER 9% 9/13/79 
BAS» INTRNS/AGGREGATE Gel 5/29/77 
BASIC <P 7/13/79 
BASIC/INTERPSM 9! B/11/779 
BASIC/INTERP SS Je? 6/11/72? 
BS5SO0G/ITEP Sol IA/AUSSTS 
GSQC/INTERP 2U rae 9/13/79 
CANDE Je5 1/14/37 
CANDE/ANALY ZER Fal! 6/24/79 
CANDE/TEACH.FILE Jee Lista l79 3 
CART/INIT fen 9/12/77 NOTE 3 
CASSETTESLUASER 5.1 9/°7 175 NOTE 3 
CASSETTESMAKER Jet TI3LS 79 
CHECK/LUAD.~DUMP Jas 7/19/79 
CLEAR/ START 904 L1/27/73 NOTE 3 
COBUL Fei’ 1/24/85 | 
COBUL/INTERPIM rae 64/12/79 NCTE 2 
COBOL/INTERPLS 94% 6/12/79 NOTE 1 
COBOL/XREF Re 5/15/79 
*COBOL74S 903 1/16/78: 
*COBUL74/INTERPIA 963 w2/i3s/79 NOTE 2 
CODE/ANALY ZER Fel 2/77/39 
CULDSTART/ODISK "Fed 2/23/82 NOTE 3 
COLDSTART/ TAPE Rell — aS 25479 NCTE 3 
*®CREATE/TASLE Ga! LA/GSS 79 
DASDOL 920 2712/3. 
DASOL/ ANALYZER 30h 1/17/72 
C3/MAP F oi 2/14/78, 
~DC/AUDTIT Bed —17347/79 
DISK/ALLOCATOR 3! 8/24/79 
DISK /DUMP Zek 8/19/77 NOTE 3 
DISKETTE/SCOQPY 90 L1i/t5/79 
DISAMAP/UTILITY J 6/13/79 
DISKPACK/INTERCHANG Ge) 94 2479 
CMPALL G0! BIL4 STS 
DMS/BUILDING Fel 24°34 32 
OMS/HELPING Ged 12/735/79 
DMS/INQUIRY JFeJ 24/16/8°> 
DMS/REORG*e READ Gee ou 
OMS/REORGe WRIT Gel 24/2578 
DUMP/ANALYZER 9 eK DTI S185 
FILE/LOACER Jef 6/14/7739 
FILE/PUNCHES Fal 6/22779 
FOReINTRIN Beli ~—64/15778 


LL 


FORTRAN Gel 7/15/73 
FORTRAN/INTERPIM ree 6/11/79 NOTE 2 
FORTRAN/INTERPIS Fe of11/7) NOTE 1 
FURTRAN/INIMAKER Sel L/i2/75 
— *€ FORTRAN? Pas 1/2473 
*FORTRANZ7/ ANALYZER 7.7 12/25/79 
*FORTRAN7/7/INTERP 3M) Je L73L/ 86 NOTE 2 
*FORTRANZ7/ INTRINSICS ears 11/35/79 
Gismod J.” 2714/38): 
GISmMO/OEBUG Fe Pe talag 
GISMO/SA 360 2/14/68" 
KASP Pree 2/79783 
FASP/MOCIF IER Je” 9/54/75 
PASP/S5P OCL 965 S/i5/79 
INITIALIZE/ ANALYZER ois 3/28/75 
INPUT/PCS.TASLES Bae 1/25/73 
LOSAD ree 2722779 
LOGCONVERT Cae 2/75/33 
MCPII | Jes 2427/3. 
MOPLI/SANALYZER eae 2/01/82 
MCPII/MiCROMCP Ie. 1/2878: 
MICROsMCP/IESUG De: 1/28/78" 
NOL | : 3/4479 
NOL/ ADDRESS ras L/2973% 
NOL/GUMP Je! 6/25/79 
NOL/LIBRARY 903 2/14 /3¢ 
NDL/NACRO rae 1/29 786 
PACK/INIT 96) 9/33/77 NOTE 3 
QWIKLOG 94! 12/23/79 
RD 945 2/36/84 
RECUVER/DATAs3ASE Fe 9/12/79 
RJE | 7.2 1/17/73 
RJE/AUTUBACKUP 5. Los 2 B/79 
mF 408: 5/25/79 
1/17/78 
S/297/79 
11/52/79 
L/D 973% 
RPG/8TF B35 LO/35/72 
RPG/INTERPIM 300 7/33/73 NOTE 2 
RPG/INTERPLS 903 7/35/79 NOTE 1 
RPG/REORD 8.9 9/30/7728 
RPG/REIRG Bet 9/6/78 
RP G/ XREF 8-3 w/e27/79 
SOLs«INTRIN/ASGREGATE © 8.5 277277187 
SDOL/ERRGRS 90% 4/23/79 
SOL/INTERPIM Jet 28/24/79 NOTE 2 
SDL/INTERPLS 90.4 — BA B4ITI NOTE 1 
SOL/INTERPLU 304 B/ 24/79 NOTE 3 
SOL/XMAP Oc 7/31/79 
—SOL/XREF res 74/32/79 
SMCS Fei 2/13 78° 
SORT ) 922 Lea73l/s79 


SORT/E SORT fek 4/27/78 


SURT/TAPESCRT Jee 2/364/3° 
SORT/UTILITY Jey ETLSs Ss. 
SGRT/V¥SURT Gait 24/56/87: 
S@UASH/USCR.DISA 90" BI21/79 
SSLUAD/MAXKCAS . Jes BI 254779 
STANDALONE/DIS&K.O0UMP Fal 1/11/7387 NOTE 3 
STANOALUNE/INTERCHANE | Jes W/ 32479 NOTE 3 
3Y Jas: i1/ig/7 9 
SYSTEM/ BACKUP Gel Li/scs/79 
SYSTEMN/32UiLUTRAIN Be? L137274/75 
SYSTEM/COUAPAKE Ge 1/23/73 
SYSTEM/CTOPY 92° 11/29/73 
SYSTEM/DISK.OUMP Je LJ 237 3% 
SYSTEM/DIS#K.INIT 90% 9735779 
SYSTEM/ELUGIUT a Fae 9725779 
*®SYSTEM/F ILZTAINTT Fal: 9/18/77? 
SYSTEM/ICMD.LINIT “Gas S/77 779 
SYSTEM/INIT Fe 12/14/79 
ESYSTEM/ISeMAINT see 1/18/6° 
SYSTEM/LOCUNTRL Loe Lis 23/77 
SYSTEM/LOAD.CAS Ie bE as we a i 
SYSTESN/LOAD.DUMP 9 ot: ee & a, 
SYSTEM/LUGOUT : Jet AP 2357 73 
SYSTEM/ MANE USER Re wwisi2s7s 
§ EM/MAKK2 3ESS Se) G/ P5779 
SYSTEM/SPOLOGUUT Get LO/61/79 
SYSTEM/TRAINTASLE Be L/ 20/79 
TASS/ATCTS 924 9/24/79 
TABS/SILLING ras, 24267 3E 
TABS/UMS 94% Tovui/v77Ts 
TASS/ERR pee Voss (ys 
TASS/EXKECL Jet 9425779 
TASS/HOWR Fed 9725/79 
TABS/LOGGOUT Feu Lo/73i/79 
TASS/MEX 94% 9/ 25779 
TADS/REPGRIGEN 9.5 2/075. 
TASS./SUM Gell LA/TAs79 
TASS/UPDATE 92” 24°97 3% 
TAPE COPY Jak 12/297 79 
TEXT/EDITOR Gee B/31L/75 
TRANSLATE/SACKUP 260 24 64 BS 
UPL rae 43a 79 
14G0/CREATE1311 o0% Gals 
L14Gc/1EP 9oef 9/31/79 
V4EC/INTERP2U ae Vs94T9 


Note 1: Interpreter is usable only or 3171" are 3183°781825 
processorse | 


Note 2: Interpreter is usable only or 819%¢5 Gist» and 81726. 
orocessors Coctner than the 318327513825). 
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Note 32 Code file used in making standwalone program cassett2» 
Cy the SSLUAU/MAKCAS programe Attempts toa execute 
the code file under MCP control should not se made. 


423252 2 lgks &eference Maruais. 


The following manuals have Seen released: 


#1267535 8 isicg/73 172 BASIC Heference Manual (€677)) 
#1LE925€o 3 L726 CANSE User ts dAanual €a77é) 
#1057197 &@ 1820/35 17703 Cozol Seferenca Manual €8773) 
PON #2: 47°79) 
© Data Comm Audit Feference Manual (€3"79) 
° Data Communications Information Manual (12° 
° @ata Management System IT COMSILID 
refererce Manual (11°75) 
#1198875. B Ligg Data Management System IT Inaquiry 
Reference vYanual (127735) 
#1251882 38 Leyc/3 1727 FORTRAN Reference Manual €a-73) 
#1099575 3 1893./6 172% HASP Reference Manual (11778) 
Aicsagiy 3 L730 MCP Reference Manual €8°775) 
#1977568 B173% Mil Reference Hanual C5777) 
81C73715 8 1832/73 1750 NOL Reference Manual (9778) 
RLEIGot2 B83 1L8SE/B 1700 RIE Reference Manual (7°73) 
¥LicS7Lé9 8B LBGG/e2 L723 KEPG Referance Marnuat (3775) 
#1931346 3 


€°Le9y6Si 3 1Lé6de/s3 17 
RIL BI9S2 3°17 
#1127222 ae oo 


5 175% SOL Refererce Manual (12774) 
1573/78 1802 Systems Reference NManuat (€2°79) 


H1iGIVS644 6 
#1108982 8 1680/5 L7U8 System Software Cperatior Guide 


Volume 1 (€o779) 
PON #1 ©2738.) 
#1108965 8 1630/8 1700 Systen Softwar2 Cperation Guide 
Volume 2 C178.) 
#1596069 3 1690/78 1720 TA2S Reterence danual €37°75) 
H1O69GC61u 3 1806/38 1706 TEXT/EDITOR Reference Yaruat (4779) 
ALCS7179 3 17390 UPL Reference Manual (€12772) 
21090676 38 1800/5 1750 378) RIE Reference Manual €4°779) 


12326 Mark 322 Release Locumentation.s 

A PCN to the 316 System Software Cperation Guide Volume 1 dated 
CzZ-60) is now available for distribution. This revisicn af the 
manual contains detailed aescripticns of all new MUP features 
available with the Mark 9.3 releases and should be raviewed prior 
to installation of this software ievel. 


References are made throughout this release document to new 


features and programs to where specific ccecumertation is 
contained in the revised 81%0¢ System Software Cperation Guide or 
in one of the supplements to this SYSNOTEL document.  Cetaited 


information on such features and programs is net included in 
these SYSNOTE1L. ~ 


ALL backup files have upper and Lower case letters ard ‘must de 
converteg to upper case if a %6 character oprirter is not 


avaiiadle. A utility oregram named TRANSLATE/RACKLP is provided 
on the system tape to translate the files from tcwer to upnoer 
case characterse | 


The following Daragracns cantatin tne? names ara a Drief 
description of the supplemental documentaticn released atonga with 
the program products in this retieise. | 


12327 7 
DCCUMENT/ 81232 ia PASSES ALS -“8143> GSEs 


DOCUMENT/314332 descrides th2 operating instructions for the 
B18 sue 


12323. © : _ 
DOCUMENT/CANDE 139 PADS ALL USERS OF GAaAnDE 


DOCUMENT/CANLDE contains the documentation for the CANJE program 
product relative to the Mark Ge: release. 


dejelte | | 
DOCUMENT/COSUL74 574 PAGES ALL USERS CF CUROL7TS 


DOCUMENT/cO30L74 is the preliminary docunentation for COSIL74. 


1232102 
QDOCUMENT/DMS 61 PAGES ALL UScRS OF DMSTI 


2llse 


i223 
DOCUMENT/CMSRELLET 2 PAGES ALL USERS OF OMSTT 


DOCUMENT/CMSRELLET contains the Hark 8.2 system notes for OMSTI. 


Pare ee 
DOCUMENT/SOASUTILS 5: PAGES ALL USERS UF BOMSII 


DOCUMENTATION/SOMSUTILS contains the temporary cocumertation for 
the OMSii debugging programs. 


1232132 
DOCUMENT/FURTRAN77 227. PAGES ALL USERS GF FORTRKANT7 
DOCUMENT/FORTRAN?7?7 contains the opraliminary cocumentation fer 
FURTRAN7 7. 


ENT/NDL 26 PAGES ALL USERS UF NEL 


DOCUMENT/NOL contains the temnorary documentaticn fer NOL. 
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1232152 
DOCUMENT/RD 1:7 PAGCS ALL P1¢o7%o USERS 


DOCUMENT/ROD is the oreliminary reference mrarual for the RD 
program producte 


1696165 
DOCUMENT/APG.DHS 3. «PAGES ALL USERS OF 3FG 


DOCUMENT/RPS.OMS contains tne documentation oan the «PG tnterface 
to CMSII. 

A Ls. 

MENT/3M6CS L47 PAGES Al. Pot aS OF 63 CS 


DOCUMENT/SMCS is the preliminary refererce maruel fer tne SACS 
program producte | 


123218 | 
DCCUMENT/SORT 19 PAGES ALL. Sis * USERS 


DOCUMENT/SURT ts the preliminary reference manual for the sort 
procranse 


i eje i Je 


DOCUMENT/SYCUM 215 PAGES ALL USERS OF SYCaM 
COCUMENT/SYCOM is the preliminary reference manual fcr the —6SyYcoM 
program product. 

NT /SYSNOTE1 139 PAGES ALL 213506 USERS 
DOCUMENT/SSYSNOTE1] 15 the name of this decunente 


Aeiecis 
DECUMENT/SYSNOTE2 33 PAGES ALL S1i5c0 USERS 


rd 


DOCUMENT/SYSNOTE2 contains the known errors and restrictions for 
the Mark 9.6 release. 


Ze 
(ENT/UTILITY 47 PAGES ALL #1020 UStas 


DOCUMENT/UTILITY contains temoorary documentation fer the systea 
utilities. 


ED ED WE ee 


geile Introductions 


The Mark 923 release cf the Master Cortrotl Program (4€P) contains 
numerous enhancements» and corrections to facilitate systen 
utilizatione Implementation of the CutcL74 language has 
necessitated changes in the nandtling of prirter files» and nas 
added certain file attributes that ara- availacte to att 
languages. These changes and enhancements are cocumentad in the 
following paragraphs. 


The Mark 9e}3 MCP permits a Mark 7el user pack te D2 readied under 
Mark GeGe Thea 4CP converts atl Mark 7.2: disk file headers to the 
Mark 9ey format. when changing the system configuration from 
Mark 929 to Yark 72% ail user packs nust first be reacied on the 
Mark 8G release of the “CFs jas Mark 7.2 35 not ecuiooed to 
handle 96% disk file neader formats. 


Object proyrans conptled or executed under tne Mark 425 system 
Software can not sussequentily Se executed under crior released 
system software. Also» due to the changes te the Cisk Fite 


Headers» ali system utilities from prior released system software 
should not De executed under Mark 9.2. 


It is recommended that the Lagic Improvement Netice (CLIN) 
82827839 be tnstalled on alt 31455 duat processor systems along 
with the Mark 3eG releasee. Tnis LIN tdentifies which processor 
is the Masters and which is the Stave» and aids in system 
deDuggings as this information is orinted in the system memory 
Gumpe LIN 8262739359 will be ragquired to execute the Mark Lued 
System Software on a dual processor. 


2222 Enhancenentss 
Ze2ele 


File attributes have been added to support the imoleéenentation of 
logical pages» and variadle Length records in CusOL74. sesides 
being included in the COICL74 syntax» these attributes are 
avattabte to atl tanguages through the "FIiLt" equation control 
cCcamande Refer to Temporary Documentation fer a description of 
these atitrioutes. 


2h2as 

The mechanisn for writing to a printer file has oOeen changed in 
the MMCP to speed up the process Oy creating fewer physical 
writes to the printer. The MMOP now tanks ftogical writes to a 
printer file until the MMCP can perform 2 ophyscial write that 
conforms to the hardware makeup of the printer Cwriter» then 
space). A description of this mechanisn» and the ranifications 
for the user are described under Temocrary Cocumentationr. 
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C2L23e | 
The output of the "CU" command has Obe2@n ennhancec for the Mark Fe 
release. Refer to Temporary csocumentatiaon for an example of the 


new out pute 


ZeLeke 

The "LO" MCP input message no Longer means "Lead Cassett2"» dut 
mow means “Log Comment”. This command attows an coa@rator to 
enter necessary comments into the systan Log. A cescriotion of 


the syntax of this command 1s jiven ir Temporary Cocumentation. 
Documentation for executing the SYSTEM/LUAD-CASS oregraam 15 
availaote in. the form of 3 printer Qackup file named 
DSOCUMENT/UTILITY. 


fe ates of the "WS" ¥CP input nessage has Seer changed to 
Query the state of only tne ACTIVE schedule» cr only the WAITING 
schedule» or ooth Cas tn previous releases). Fafer to Tenporary 
Documentation for the syntax of this commance 


222 29s 

The use of the "THEN" commard for jod execution has seen expanded 
In tha Mark Gey MCP. The “THEN” command way row de used after an 
TADD™» "COs "COMPARE %>» "CUPY"> "DIk™> WEX*%> WLOW> WLGM, ML Ms 
FPG™>s "PM" or WRCO™ conmand. 


g22s fs 

The MCP now checks the availatile tadle before attempting to 
return a disk area to the availabte table» theredy avoiding the 
creation of an overlapping area Ct1"*5607 708719) | ) 


? og Pas] J . 
When a write occurs to a random disk file with an invalid keys» 
the error message given by the MfP is now censistent in all 
CasSe@Se 


Lele2is 

The MCP now gives the error message “Lex is NQT A TSEAIN PRINTER 
OR THE TRANSLATOR IS ALREADY LCADZO" af the command "LT LPx™ is 
entered and “LPx"™” 1s a 879249 COGCC) orinter Clinm735"wW30479). 


2ke2ives | 

The MCP is now more consistent in tne error message arinted when 
a read operation is attempted on an outputscnty file C*READ 
REQUESTED ON GUTPUT FILE"). 


2eZellie : 

The MCP now passes charge numbers automaticatly in “Zip™ 
commands. A charge numter appearing in the “"ZiP™ statement» 
however» overrides the charge number of the "ZiPping™ program 
which is passed by default. The charge number supplied by a 


usercode in the ZIP statement also cverrices the cefault charge 
number. 
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LelZelds : 

Endwof-fite tis no longer reperted to 3 user procram when a Dackup 
file is being created. The MCP automatically clos2s the file 
when it is fulls and automatically opens a rew Backup file The 
identifter assigned to the second file reverts tec the standard 
naming convention for Cackup files. The family name secomes 
"BACKUP ePRT™» or a usercode if file sacurity 15 in effect. The 
filetid is a backup print numcoers» maintained sy the x#4CP. Atk 
file attributes assoctated with the first backur file are 
retained in the second Dackurc file. The o¢e@rator is notified of 
the creation of the “extension” file. 


e221 3s 

The MCP can now accept more than two operator ceanmands in a 
Single input stringe Pravicusly the “CP's scanner weuld only 
accept two comnmands» and inproperty interpret any successive 
commands tn the same string C2ax5e. PMs Ps 2993 EG). 


£eLZei4e 
The MCP no Longer flushes a pseudo reader wher the joo that 
created it goes to “EEUU. 


£222152 
The MCP now pernits portions of low menory ClOxxxx)d to de XMted 
without causing a halt in the SuUDdsequert "CLEAR/SSTART? 
C12°0977°0M1494). 


Lelel be 
An invalid field in a header label on disk ne tLerger causes an 
MCP halt during open. 


wWINVALID HNEMONIC™ MCP outout message now frints the token 
that was tn error €13°73387AL5%33). 


£2221 8e 

The MCP now permits the open of a disk file with zero areas 
specifiede The MCP uses the value for areas in the disk fite 
header for the file. This pernits a user to ceen a file without 
knowing the number of areas in the fite C157 33 3°ALS3E1). 


Le2elFe 
The MCP now properly naintains the run structure status when a 
job 3s stopped with the "ST™ command. A subsecuent "AY" command 


specifies that the job is stopped» and the status of the joo 
before it was stopped. : 


Invalid (nonexistent) queue names that are fourd in a pseudo 
reader are now ignored» causing the parent queue 2nd the "LS" 
boolean to de set to zero for the joo betng executec. | 
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LeZelis 

Closing a tape with "NOenc WIND” when not at the end cf a file no 
longer causes tne tape descriptor chain tec he corrupted 
C13"S$a8°"Gau 300).~ 


Lelsziie | 
The MCP now checks the Integrity of the cack tlasel whenever the 
pack label is read. 


£22e232 : 
The MCP now increments the data overlay court for Sv0L/UPL paged 
arrays every time a dsta overlay occurs. 


2. ¢ ®: 4 a 
tee ee 9e5 MCP now gives the full file name for all "PE's”. 
This includes the name ot the pack on which the file 15 located. 
If no pack name is printeds the fite 18s Located or the system 
Dac Ke When a use@rcode/ps3ssweord orecedes the "P22" ccrmands the 
MCP Looks first on the default pack of the users and if the file 
1s not found there the MCP looks on the system ciske 


Leis2ds 

If the "VCL1i" field on a disk pack Label contains the word "DUMP*™ 
Cplaced there by DISK/DUNP) the Mark GeG MOP displays the message 
"OPx IS AVAILASLE FOR DISK/COCUMP GR CULOBSTARKRT/CISK ONLY™ when the 
pack 1s made ready (12i7388°JNO155). 


The Mark 9eG HCP only permits the “VAUTOPRINT™ cueue to 5e opened 
"INPUT"... Attempting to open the "AUTUPRINT™ cueue “QUTPUT"™ or 
"INPUT/OUTPUT™ is disallowed. 


Z2222t- 
The “CP no Longer creates 3a file of tyne “data™ when a orinter 
backup file is OUted to a disk which initially has too tittle 
avaitadl space to hoid the file €227260"780224). 


222282 
The MMCP now halts propertly when a reacer/sorter fails to respond 
to a "STOP FLOW"» and an MHCP tank overftow nas cccurred. 


£22e29e2 | 
The MCP no Longer aliows an “0U" as a response to a "NO HARDWARE” 
condition for "AUTOPRKINT™. 


SsZe3hs - 
The MCP now attaches the default pack identificaticen in the "CH" 
command when using the "USER" HCP input aessage. 


S2Le23le | 

The MCP now handles the invalid syntax when the name cf the file 
is teft out of the "NAME" attribute in the "FILE" equation 
commande 


2222322 

When there 13 not enough memcry to terminate 2 jod» thea MCP now 
displays the message “NO MeweCSY FoR TERMINATION" as the status of 
the jod» instead of haiting. 


2222332 
The Mark Ge} MMCP has Deen corrected to more carefully check for 
an invalid station in a request fron an ACS. 


Segedhe 
A usercode 15 no longer retained after an "ENDO" card» tn a stream 
of cards tnput to SYSTEM/LOCUNTRL. 


£22233 
The MCP no Longer nalts wnh2en an attennot is made tao open 4n 
optional file with "EXTEND *>» when the file is not presant 


(437 444°160065)- 


C2223 be- a | 
In the Mark $923 MCP» a program 1s terminated if it attempts to 
open a Blocked punch file. 


Lalesls | 
In the Mark 966 4CP» the "OF" command is not permitted to be used 
on a file tnat is to de opened output only. Use thea DUMMY.FILE 


£222382 | : 

In the Mark 9e2 MCP» if a program requests the Line crinters and 
the printer is in use by the MOP» due to the "K8 LP™ ception being 
set» the system resets the cption and assigns the rrinter to the 
requesting job €52°9¢69°93¢179). 


£22233 
The "GMX" Cqueue max -gessages) file attribute now nas a tower 
Limit of one nessage-e 


£22245e 
WRELATIVE”™ have been added to the types of files that may be 
specified in the FiLE.TYPE file attridute. 


2e224i- = 
The integer eneea Tied in the — FAMILY.SIZE" file attribute mnust 
mot exceed $95 (previously ios). 
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Lelektes 

The "SO" message may now ne used to specify additional systen 
drives which are on different channeis fron the original system 
Giske However» no two of these system disks ray De on the same 
unit numoer. 


£eZe43s 

When a@ jod running under a nontprivileged usercede onens a 
printer/punch Sackup disk file that nas the "USCR.ZACKUPNAHE” 
attriDute set» and Soth the nulticfitetid Cwhich is not the 
usercode) and the fiterid of the file name are srecified» the 
multicfiletid is noved to the filetia ari tne multirfileridg is 
changed to the usercode of the jobd- tnus destroying the 
userwmspecified filecid. 


When @ pack is specified in a orinter/punch dackuo disk file that 
has the “"USERe-8S8ACKUP.NAME” attridute sate the soecified packw10a 
overrides the default pack of the usercede being used to ersate 
the files» so that the file 15 not written to tne user's default 
packe | 


S2i2e44e | 

The Mark Se} MCP now permits a5 mnany 45 22 spindles of disx 
C"DPx") to be on Line at the same timee The mnemorics for these 
disks are "DPA™ through “"OPZ™» then "SPL" throuah "O0P6". 


Z222432 

The MCP now only prints the name of a newly ooened printer dDackup 
file af the “"LIs™ option is set» or if the dackup file is an 
extenston file. : 


 OOTING 
attribute “"“"FOCTING"™ (Cwhich may 9e aDOreviated "FOOT" 
specifies the number of tines from the beginning of the page 
bedy» within “"PAGE.~SIZE™» to the point where the MCP begins to 
report end~of~page to the user. The "CN cOF™ branch 15 taken in 
the program» odut the recerd 13 still written» unrntess the record 
would Oe written an the tower =*margin» in which case @ pace 
advance 1s made to the d5eginninj3 of the next tosgical page. 
“FOOTING” may be set to. any value from 1 to 255 inclusive. 


LOWER eMARSZN | 

The attridute "LOWERA*MARGIN"™ Caobreviated "L.e") scecifies the 
number of Lines to teave blank Detween the page oedy of the 
current page and the upper margin of the next page. The 
"LOUWER.MARGIN” may be set to any value from § te 253 inciusivee 


2c 


MAXRECSIZE | 
The *"MAXRECSIZE" fite attribute specifies the maximum record si122 
for a variable Length recerd file. This attribute ts equivalent 


to “"KRECIQRD.~SIZE". 


The "MINKECSIZE" file attricut? soecifies the rinimunr record size 
for a variaole length record file. 


The “PAGESIZE" file attridute Caobreviatad "P.S") specifies the 
number of Lines Between the tuoser nérgin and the lower margine 
"PAGE eSIZE™ may Se set to ary value fron 1 to 255 irnclusivee 


UPPER SMARGIN | 
The “UPPERsMARGIN" file attribute Cabdreviated "U.M") sneci fies 
the number of Lines to skip at the beacinning of the ltegicat page 
before the page bodye The "UPPERSMARGIN" may be any value from ¢& 
te 255 inclusive. 


The logical page size snould oe calcul3ted 
such that the upper margin plus the page body 
olus thea lower margin equal the size of thea 
physical Pagee If tnis 15 not dane» 
eventually a Line will be printed on the 
crease between the ponysical pajese 


2eh222 LogicalsPhysical Printer Jutputs 
The Mark Yey MMCP now Duffers Logical printer cutput in order to 
take advantage of the hardware architecture of the crinters and 


to create only one physicat cutout for each Logical output. 


The following diagram disolays the relationship between a logical 
write operation to the printer» and its affect on the ohysical 
output to the printer: 


\ 
Current\ Pending 
Logical \ Operation 
request \ 


j Nuli Arites» No Space Write Jefore 

: | Single Space 
* dieotaetasettericebenieietatetonteatcateted: dnteialeteten wm er ewes eee pee ewen=~ weer eres ny 
Write» i No7op | i writes No Space 4 Write» Sreace i | 
No Space | Pending = i Pending = i Pending = : 
i write» a space i Writer No Saace 1 Nrites No Space | 
troeceocess= weacee epowoc aces ea wew ene pees eee seen ee ee= -~+ 
Write/3 3 No™ap - 4 Write» No Space 1 Write» Space i | 
Space 1 jj. Pending = 1 Pendinj3 = | Pending = i 
4 Writes» Space 1 24 Writes Space 1 JI write» Space 1 1 
t= se= 5 == eS a ee {eS en AS ma Se $e ee een een = wantin my 
Write/8 1 writes Space 2 1 aArites No Space 1 Write» Space 1 i 
Space 2 14 Pending = Null i writes» Spac2 2 Jt writer» Space 2 | 
j 1 Pending = Null i Pencins = Null { 
focenece- ewe new eee eww se neces oe eee e ee en ese ee-e —or m+ 
write/A i aes i i drite» eanee 1 4 writes Space 2 1 
Space l 43 Pending = j Pending = { Pending = | 
lk aArites No Space | Arita», No Space {| Write» No Space it 
Si saab ec as as ca a Daeg ind ce eta pases ein a aoa ie ae woes 
Write/A 1 Space 2 l icaeee Swace 2 1 writes» Seace 2 | 
Space 2 UL Pending = i Pending = i Space 1 1 
i Writer No Space | drites No Ssace i Perdjing = i 
1 l i Writes» No Space | 
pit a en ee en gy eee en pe en nn oe eee ny 


Write/2 1 Writes Channel | write» No Space ! Write» Space 1 1 


Channel | Pending = Nutt 1 writes Channel 1 Write» Channel | 


{ | Pending = Nutt j pene yes. = Mult l 
> we swe ee am 0 am an a an en am ~ + Le Se ee ee ee eee EE Ye = jp mee 2 SS Se SE wee ee a oe a 4 
Write/A & Spaces» Channel | arites chanel i Writes Space i] 
Channel 1 Pending = i Pending = 1 Space» Channel | 
1 Writes No Space |! Writes No Space ij Pending = i 
i j | i Writes No Space } 
oe ee 2 nec awanae Joana ana en an ae om mt 
Space N 4 Space x { Writes Space x 121 writes» Space 2? | 
i. space (Nx) i soace (Nx) i Space (N71) | 
i Pendyag = eee 1 Pending = Null 1! Pending = beaks i 


a =— nn 2 ae an a a eo +} a. =) on =e on ea: Ma em Cel homdiiend 2 ee ee Oe ee ee ee + 


Figure 1 * Logical/Physical Gutput Relaticnship 


In the preceding diagram» the oparations within the table 
correspond to the actual physical output operaticns that are 
performed» depending upon the current Logical reauest supolied by 
the users» and any operations chat are still pending from the 
previous request. write/& and write/A may de read "WRITE SEFORE 
ADVANCING "so and "WRITE AFTER ADVANCING”. "Space x" in the 
diagram is a space of 1 Cif N = 1) or 2 Lines Cif N 15 greater 


than 1) on the printer. Tt should oO2 noted that a esecond 


physical write to the Pees is only sent if Nx is greater than 
zZeroe | : 


- 
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As can De s@en in the diagram» the ohysical position of the 
printer 18 usually one tine of output behind the object orcgram. 
Orly when the Pending operation in the diagram 1s set to a null 
vaiue does the physical position of the printer correspond to the 
position the odject program cetieves it is ine: 


This phenomenon shoulc present no groodlerms for ary existing 
printer programs unless the comouter operatcr is recuired to lock 
at the last tine of output and in order to do se» rust manually 
acvance the paper. Under these circunstances» the coerator may 
not see the actual last Line of output written oy the programs 
and may ups2t the format of the tisting Being printed. 


Of particular concern are thos? orograms which use scecial forms 
and which contain a “Forms Atiignnent”™ toope These toogps 
typicaily write one page of dummy outcut cn a special form» 
advance the printer to the next torme display @ nessage asking 
the operator if the form ts aligned correctly anc perform an 


“ACCEPT” operation» waiting for the reoly. 'f the gerogram does 
not advance to the next forsn ttself and if» in order to see the 
Guamy output that was written on the form the cperator must 


manually advance the paper and if the tast logical operation 
performed By the program left a Pending operaticn that was not a 
null value» changes are probably necessary in the program. If 
the operator does not mnanuaily advance the papers no changes are 
necessarye | 7 


It can be seen in the diagram that some Legical requests result 
in two physical operations bCeing iritiated. Urder these 
conditions it nay be beneficial to supoly each printer file with 
at least two Buffers» if the execution time of the crogram is the 


only concerne Total system tnrcughput 15 net impacted 
Significantly regardless of tha numder of orinter Suffers and the 
types of the operations being performed. lf the MCP wust wait 


for the completion of any printer ohysitcal cutput operations the 
time that 1s spent waiting 18s masked Sy the processing of other 
programse 7 


Along these same Lines» it should de remembderea that any time 4 
write operation 15 Left pending and control is returned toa the 
users the MCP must have an availadle buffer to stcrea the data 
that is to be written. If no Duffer is available» control may 
net oe returned to the requesting user untit a douffer decones 
avatlablee. Again» this time is overlapped with the processing of 
other programs and system threugnhout shculd not be significantly 
impacted.. 


25 


gZesed2 CU Conmand. | 

The output of the *“CU" command has deen eanharced to more 
comoletaly indicate the allocation of system mamory» or program 
memor ye The following 15 an examole of the cutout of the "CU" 
command when no job nuaber 185 given: 


CU 

CURE USAGE = 22397321425 

SAVE= 125686 SYTES 

LARGEST GVERLAYASLE= 716335 3YTES 


PAY =1262 SAVE= 29771 SYTES » JVERLAYASLE= 24957 SYTES 

LED =1264 SAVE= 31334 8YTCS » GYERLAYAGL C= 642565 SYTETS 

PAK =1262 SAVE= l2to?v BYTES » GVERLAYAGLE= 06435 S8YTES 

INV £1205 SAVE= 626 SYTES » CVERLAYASLE= 2 sYTES CROLLED JUT) 
REC =1266 SAVE= 1133 3YTES » GVERLAYAcLe= ONTES CHCl OUT) 


The fotlowinyg example shews th2 output cf the "CL" command when a 
joD number precedes the command. 


Lz6o5cu 
INV =1265 SAVE= 626 3YTES » CVERLAYASLE= © SYTES CHOLLED JUUT) 


gese42 LE Conmands ; 
The new “LC™ command attows the operator to erter conments into 
the system loge The syntax of tne "LO" commanc is as foltows: 


>a LO = <string> -7-1 


<String> is any string of characters» and is the comment desired. 
<String> does not need to have quotes as delimiters. The maximun 
Length of <string> is 165 characters. 


ge3252 WS Command. 
The syntax of the "WS™ command has been enhanced te permit the 
operator to request that onty the ACTIVE schedule de crinteds» or 
that only the WALTING schedule be printed. The syntax of the 
"WS" command is as follows: 


pom HS eeerere <job number> oe-7} 


t i 

Pe ACTIVE sees eF1 

} { 

fo" WALIING = =s33 =] 

1 i 

j-- =f= ss eee <i a ala j 
£23282 Complex Waite | 
A change has deen made in the MCP"*s handting cf 4a complex wait 
between Mark 929 and Mark 10.7. in alt releases threughn Mark 
Jer the MCP considered a wait of zero tenths of a second as a 
watt of one tenth of a Second. In the Mark 10e4 release a wait 


of zero tenths as one of the conditions causes the progran to 
fall out of the complex wait as soon the wait statement is 


encountered. Depending 
Detween Mark 9-3 and Lie’ 
satisfied for different 
into consideration for all 
the complex wait function. 


togic» the difference 
comelex wait to be 
change should be taken 
involves the use. of 


on the program 
may cause the 
reasonsSe This 
crogranming tnat 


Zels Introductions 


The Mark 9.3) firmware contains major changes to the SEL and RPG 
interpreters» designed to increase perfornancee The Aark 9.3 
firmware also contains three new interpreters» utilized oy the 
new FOR TAAN7 7» COUBS30L74» and ILdaASICT Languages. 


The SOL and RPG interpreters have nad their rurmbder cof s23gments 
reduced from fourteen to six for SOL and from four to one for 
RPG. 


The MCP.LEVEL field checked by the MCP at 304 fer alt orograms 
has deen raised from 3 to 4 for all interrreters» meaning that 
Mark $e3 interpreters cannot de executed with Mark &.° systems. 


3232 Temporary Docunentation.» 
sesele ft 


ARCHITECTURE.NAMES "SOL" 

COMPILER.~LEVEL: 1 

MCPeLEVELsS 4 

GISMOe.LEVEL:s 3 

ARCHITECTURE.ATTRISGUTES bits that are TRUE: 
2> 39 Abs Se be Ff» Be 19» Llse 125 13% Lhe 15 

segments: 6 


COBOL Interpreter 


ARCHITECTURE NAMES "COBOL" 

CGMPILER-LEVEL: 1 

MCPeLEVELS 4 

GISMO.LEVEL: 3 oan 
ARCHITEC TURE.ATTRISUTCS bits that are TRUE: G&G 
segments: 4 


COsOL74 interpreter 


ARCHITEC TUREANAME?S "COS8uUL74" 
COMPILCReLEVEL: 1 - 4 

MEPeLKEVELS 4 

GISMO-LEVEL: 3 

ARCHITEC TURE.ATTRISUTES bits that are TRUE? None 
segments: 1 


PG Interoreter 


ARCHITECTURE SNAME: 
COMPILERKeLEVEL: 1 


MCPeLEVELS 


io 


GESMOeLE VEL: 
ARCHITECTURE AATIRIG 


G» is 2» 
segments: 


1 


4S» 


3 


BASIC Interoreter 


4» 5 


ARCHITECTURE «NAME? 
CUMPILEReLEVELS 3 


MCPeLEVEL: 


4 


GISMO.LEVEL: 
ARCHITECTUREA 


segments: 


1 


5 


TTRI 


SABASLE Interagreter 


ARCHITECTURE «NAMES 
COMPILeReLEVEL: 1 


MCPeLEVELs 


4 


GISMOeLEVEL? 


ARCHITCCTURE.ATTRI 
1 


Segments: 


3 


EQRTIRAN Interpreter 


ARCHITECTURE .NAMES 
COMPILER.LEVEL?: 1 


i 


GISMIJeLEVELS 


ARCHITECTURE. ATTRI 


segments: 


FORTRAN 


H 


5 


ARCHITEC TURE«NAMES 
COMPILERSLEVEL: 3 


MCPeLEVELS 


4 


GISMO.LEVEL: 
ARCHITECTURE -ATTRISUTES one that 


segments: 


1 


3 


SUTES bits that 


we A0L GC" 


JUTES bits that 


"ToASTC" 


PUTES pits that. 


"FORTRAN” 


BUTES bits that. 


ff interoreter 


"FURTRAN/7™ 


are 


are 


are 


are 


TRUE Ss 


TRUE: 


Kone 


None 


None 


BSuG Interoreter 


AKCHITECTURE NAMES "8555" 

COMPTicReLEVEL: 2 

MCPeLEVEL: 4 

GISMO.LiVELs 3 

ARCHITECTURE *ATTRILUTES cits that are TRUE: 
Segments: 1 


ARCHITECTURE NAMES "140 ;" 

CUMPILEReLEVEL?: 2 

MCPeLEVELS & 

GISMO-LEVELS 3 

ARCHITECTURESATTRizZuUT¢cS bits tnat are TRUE: 
segments: 1 


Bisse 


GISMOeLEVEL? § 


None 


None 
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4ele introduction. 


The Mark 3.39 release of the nPG compiler inchkudes ccecrrections to 
cutstanding proolens» the new OMS “"eALL™ entry» imolerentation of 
the Urindicators for OMS files» and compatibility changes to the 
"DeELCT™” operation codéee 


A printer backun file tLabdeled “"DCCUMENT/A2PEC.D4S" cantains a 
number of RPGS GMS programming examples as wetl as decumentation 
of the "D¥SOS8UG" debugyinga aid. 


eZzele | 

i 

nm input file with stacker select was cpoened troput/outouts, 
allowing for possicte erronecus punch failures C4erL4ee 2 poctode 
An input file with stacker selact 15 now opened incut onlye 


heoZeces 
The "XFOUT" operation code using “HALF ADBJUST™ cid not half 
adjust sropertly if the result Was a minus quantity 


C54°626°0M1142).. 
"XFGUT™ with "HALF ADJUST" on a negative quantity row generates 
the correct resuite | 


foZess | 
The RPG Compiler was not syntaxing OMS files which began with a 
blank charactere Instead the MCP displayed a console message 


"ATTEMPTED TO OPEN OMS-LIBR WITH 157 CHAR OF PACK ID OR MFIO OR 
Fid BLANK” C13" 3353878. 99 99). 
A fatal syntax error is now given on an invalid RPG name for a 


422 4 = 
An PG program wouid hait with "INVALIO SUBSCRIPT OS OR OP™ when 
a Calculation Specification contained the fallowing: id) ™MOYE" 


in the “GPERATION FIELD™ 2) A subscrioted array in "FACTOR 2» 
ang 3) the sudscript of the array its also specified in the 
"RESULT FIELD" and the value of the sudscripted array which is 
Deing moved is larger that the "ENTRIES PER ARRAY™ specified on 
the Extension Specifications €13"335-6.17 75). 

This prooiem has Deen corrected. 


heZede 

A "MULT" operation code where the larger number was specified in 
"FACTOR 17 executed faster than if the larger ruber was 
specified in "FACTSR 2". | 7 

This problem has been corrected Dy passing the targest number to 
the interpreter as “FACTOR 1". 
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2226 

A syntax error was not generat2d when column 52 cf the input 
Specification (the "DECIMAL PUSITiONS FIELO") contained the 
letter "0" C3ir175°CLIgt1). 

A syntax error 15 now given when column 52 oof the Input 
Specifications contains anything excerpt the digits *7S or slank. 


4eZels 
A syntax error 15s new generated when a "KEAD™ oparation code is 
specified for a OMS file. 


Gn the Gutput"Format Specifications the cembination of an 
unsubscricted taole in column 32 and a CASDL@cefinedc fietid nane 
in column 17 148 now atlowed. 


ba2eIJe 
When columns 6%3705 of the File Description Specifications were 
nansolank~» for a file where the core index was neaningl?ss» no 


Warning waS given. 
A warning is now givene 


4e2e1t = 

For the Mark 966 release the use of the word "**ALL™ In columns 
53756 of the Inout Specifications and cotumns 472743 of the 
Gutput"Fornat Specifications relieves the user fron having to 
code the fietds for these specifications wnoen GASDL defined names 
are usede Refer to Temporary cCocumentation 4-3-1 fer a complete 
description of the new "#ALL™ entrye | 


if a DMS file name declared on the File dOescriptian 
Scecifications was not a DASDL-defired data set nanes the DMS 
file name was not syntaxed by the RPG conpiler. The result was 


that the operator had to intervene with a "OS" or "OP". 
A fatal syntax error 13s now given on an invalid RPS rane for a 
DMS file. 


Reserved words "UDATE™» “UDAY™» "UMCNTH™s "UYEAR™s and "UDATE™ 
were not syntaxed tf used as fieid names on the Input 
Specifications» in the "RESULT FIELG"* on Calculation 


Specifications» or as field names on Qutput Format Specifications 
using Olank after. 
This prodiemn has been corrected. 


4e2e2i32 | 

The Record identification Indicators were being turned off prior 
to checking the status of the Halt incicators CHOTHD) 
C137 336" 2.9713)6 | 

Now the Halt Indicators are checked before the Record 
Identification Indicators are turned off. 


Ly 


The RPG compiter did not give 3 syntax error when a tLiteral 
subscript for avector in column 53 of the Input Specifications 
or column 32 of the UutputrFormat Spacifications was outside the 
rance of the wsASOLe*definedc vector itn column 44 cf the Input 
Specifications or cotumn 17 of the Cutput"Format Soecifications.e 
The compiler now gives a syntéx error for the above conditions 


4222152 : 

The external indicators CU1L"Ud) are now allecwed for OMS files. 
Refer to Temporary dJccumentation for a descriopticn of external 
indicator se , 


>: <> > aa 


The alphabdetic entries "ND" or "KK" are now allowable ertries In 
the “SEQUENCE FIELO" Ccotumns iS716 of the Ingeut Specification). 


é 


letter "J" inserted itn colunn 21 cf the Control Card 
Specification was not producing the desired print format (the 
leading zeros wer? b28@ing suppressed) (C(T1"7C32°9"1 G31). for 
example what should have teen "Get 2" was printed as "75%. 
The Letter "J" now produces the correct formate 


4o2eols | 

The "DELET" Operation Codes used for EMS files» must now contain 
the letter "5" ain cotumn 53 of the Calculation Specifications 
Previousty a blank was required. The purpose for this change is 
to maintain a standard ocetween other Burroughs RPS conpitlers for 
the sequential deletion operation. 


4e3- Temporary Dacumentation. 


SeZeie *ALL Entry. 

Prior to the "*ALL™ entry the user had to explicitly define the 
Input and Dutput“Format Specifications for data manacement files. 
The "*ALL™ entry does away with this requirement. 


The syntax for the "*ALL™ entry and some examples are2 given 
Delon: 


irput Statement 

The we ALL" entry anpears tn cotumns 53°56 of the Input 
Specificatione This still altows the user tc de record 
identification of OMS files. The following tennolate 1s used in 
the “#ALL"™ RPG"DMNS examptes to reoresent the column numovers 
within the Input and Output*Format Specificatioarse 


calmptine taeloaad Gaal taalrah Marlee ce Beene, Sania tacit deals Sosbaedoas * Ceiba tad Merle codicaie edule! ciediainlial 5 vas — am femme nn 


Le IA *£ ALL 
This ts the same as the user coding: 
TA 

I | X 

i Y 

X and Y are the only OFS variaoles tin data sat Ae 


Ze TA e# ALL 
I x g 


This is the same as the user coding: 


IA 

I X X 
I Y Y 
, X aq 


2 enon fy an en alte A ae a a om ase yuwes aw 3- an fe a ee 4 =o = yo a ef naam Oy ma 5 a en ey aw oe 


I x x Li 


This. axamole shows how the user can effect cortrei levels» 
matching fieidss field record relations or field indicators. 

In the above example 3 controt Level indicator “L1" 15 assignec 
to the field "xX". Tt 153 as though the user had coded the 
following: | 


lA 
i xX X Li 
I 7 Y 
he IA 1 i CA x 
I | Y A 
I v2 1 Cs X * ALL 


This is the same as the user coding the followirg: 


fA gl i CA X | 
‘- Y A. 
I G2 1 C3 X 

i Xx X 
I Y Y 


mn op a a am |= <-> _~_ ow ee CSA ASS Se a es wm {jones fy me on oe fe wom & —<—f_- = mf wm wo 


5 = 
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In this exanple» assume that "X" and "Y*" were dectared in 
the GASDOL source as "NUMBER C4e 59" and "FR" anc "5" were 
were declared in the DASCL source as “ALPHA (€3)". 


I wil 

I | R x 

I S Y 

I 32 * ALL 
This is the same as the user coding: 

TA ot | 

I R X 

I | S Y 

i Ge 

I X X 

I Y Y 

I R x 

J is) S 


The field lines coded for the 31 indicator defire tocatl 
Wartables "X™ and "Y™ as "ALPHA (39%. The fietd lines 

praduced by the "*ALL"™ entry define Local variacsles "*X" 
and "Y" a5 "NUMBER C400)". This produces the foellcwing 
syntax arrors “"REDEFINES FIELD NAME. 


TA ul 1 CA Y ®k ALL 
I GR G2 | 


This is to illustrate that the "*ALL" entry applies to "UR" 
lines. which follow the first record Lines. The same applies 
to "AND”™ Linese This is the save as the user ceding: 


IA i rn a, Y 

I OR v2 | 

I x 
I Y Y 


a. lei 7-3. xo coe 2 nea y_ aoe ae 3 cam my seie= on oh fp mm a oe 5 a a oe fe a on ae 5 a ey oe o= 
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Sgurce Listing | 
The following example of a4 source Listing contains the Input 
Specifications which the KPG compiler generatese Tne RPG 


compiler generated tines have a pound sign €#) tin column 7 of the 
input Specifications. 


For example if the user coded: 


IA ALL 
The resulting source listing 1s? 
IA # ALL 
if X 
IZ x 
0 De ae a ee jw2-<-x--< pm gow cexe --- 3-- ow yraece fom go 2ee5- an af ow ae 6°-" a 


If tne user coded? 


1A ez ALL 
I | X x Li 


The resulting scurce Listing is: 


IA | *¥ ALL 

1 X X | ii 

le Y : 
GQutput~Format soecifications | | 
For GutputwFormat Specifications» the same cencepts aoolye The 
"*eALL™ entry =i18 contatned tn columns 43743 of the Gutput "Format 
Specifications line. Output"Format Specifications are generated 


only for those DAS£Lirdefined items which have peen ereviously 
defined. | 


le GA >: 61 # ALL 


This ts the same as the user coding: 


CA 2 OL 
8) x Xx 
0 Y Y 
Ze GA E g1 *ALL 


0 X | +? 


This is the same as the user coding? 


OA E 61 
g x +2 
Q Y Y 


2 a fp am a ji = oko _ 2 =m ae yb an oe safe = Fh aentie iene) 4 — a we adiadinaieae Yondinadioad “= a ““b oan ae em a 
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aoteraction | 
The following example shows the interaction dDetrween the Input and 
Output*Format Specifications. 


1A vil 1 CAD X # ALL 
I we 
I X x 


This is the same as the user coding: 


IA Gl 4 CA x 
I x X 
I Y Y 
I 2 
I X x 
wee pew ee Lemme geome Jeet ego ee Jes we ges ewww ew, ewe now ee se teem fe rerexeeces 


At input time» tf "X" has the character "A™ in pcsition is the 
record identifying indicatecr 71 1s set on and *"XK* and "Y" are 
moved ine Otherwtses the recora identifyirg ircicator 22 15 
set on and "X”" is moved ine 


Assume the user codes the UCGutput "Format Scecifications as 
follows: | | 


CA é | ®€ ALL 
Both "X* and "Y" are written at exception time. If the input 
record was an 22 type» the value of "Y" is either the value at 
input time or the resuit of 2a calculation operaticn-. This may 


be reasaonadle» or tt may note 


Code to Avoid | | _ 
Several instances involving the **ALL"”™ entry shculd ae avoided. 
These cases are scheduled to ba fixed in the next release and are 
described delow: 


In the described examples soth $."X" and “Y"™ are OASOL“defined 
fields. 


1. OA *ALL 
Y x 3 


a: :  Toliealinteals & ae oe mf ae ow ue 2 0 ea ee ay Se ee eee 4 ~~ aw me de ae ee an ee 4 a OS fo ae ot, am ee we 6°7"-° a jp ae 
The following code 1s generated: 


Cline 13 Y x 
Cline 23) x X 


Lee 


The RPG compitter generates code to rove olank characters to the 
~DASDLedefined field "X" after the value of "X" is faved to the 
DASOLsdefined field "Y". The RPG Compiler then generates code to 
move the value of "X" to the DASDL-defined field "x". Since the 
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value of “"X"™ 15 olanks» the resulting output of "X" is blank. 
Note: that this proclem results when beth an RPS and 
BDASSiLedetined field are called the same name and the blank after 
1s usede 


Ze IA * ALL 
| Y AoX 
The following source code would be generated: 


Cline 1) Y A»X 
Cline 2) X X 
The value for "X" 15 not kncwne Again the erecastem results 


because both DaAdsdDLetdefined and FPG-defined fields have the same 
namnee 


4s3ac Corrections to the RPS Manual. 

Piease make the following changes to the #8L83C Systams Report 
Program Generator CRPSG) Reterence Manual» form-# 12571389 dated 
August 1579. 


le Keference page 8~3. 


Under columns 715716 SEQUENCE" delete the paragraph reading “*When 
coding this fteld» the programmer must not use the alochabdeatic 
entries NO or Rb Cbd equats blank)>, because the compiler may 
mistake these for the ND or ® of an AND or OR Line™. 
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2e Reference page 4729. 


The "LABELS" field», column 53 of the Fite description 
- Specification is renamed to Ge the "FILE OPEN" field. 
| 


Valid entries for this field are as follows: 
Entry RBefinitian 


tiank Standard Systen Labels are expected/proavided 
for this file». if the file is a disk file» access 
to this file by other programs is not restricted 
_white the file 1s opened Gy this orccram. 


a For printer filess indicates that the file 15 to 
oe forced to Printer 3ackup.e 


For card files> indicates that the file 1s to be 
forced to Punch Backup. 


F Applies to printing files ard irdtcates that special 
forms are required. 


L Applies to input or update disk files and indicates 
that this file 1s not availadile to cther srograms 
while the disk file is apened Dy this orogram. 


R | Appiies to incut or update disk files ard indicates 
that this file ts availaole te other programs for 
input only while this disk file is cpened Dy this 
programe. | 


U | This file is Sapa creas prove dee as an unlaoeled 
files 


$e Reference page 5~d-6 


Figure 572 tine uF columns 46 through 57 should ce shown as 
optionaie Add the letter "CC" to these colunnse | 


4. wkReference page 13-20-6 


Under columns 286732 a FIcLe™ delete item de "FORCE" is 
a valid eer eEtors 


Se Reference page 13-22. 


Under columns 54°59 "RESULTING INDICATORS” refer te ttem 1 of 
paragraph De The statement reads "Tne data set specified in 
FACTGR 1 for the FIND» LOCK» FREE» TREEG» TREND» STORE» and 
DELETE operation codes". The statement should read “The data set 
specified in FACTOR 2 for the FIND» LUCK» FREE» TREEGs TREND> 
STORE» and DELET operation codes” | 
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6e Reference page 1379 
Change 67774 to 6777.2 Add the following: 


71-72 FILE CONOITION 

This field nay be used on input» updater» outout and restart data 
management files and indicates whether or rot the file 1s 
conditioned oy an external titndicator. Tf a GM6MS fite 1s 
conditioned dy an external indicator the file is usec onty when 
that indicator 15 one When tha indicator 1s off» the file is 
treated on input as if it 15s at the end of file. In Calculation 
Specifications» if any OMS operations are done to the conditioned 
file>» the operations should %e conditioned or the Same 
Urindicator specified for the OMS file. if thea CMS operations 
are not condittoned py the same Urtncicator and one of the 
indicators is off» the operations are ignored and th2 91 
resuiting indicator» if used» 153 not affected. Likewise any 
output done to the OMS fite should be conditioned by the same 
Urindicator used on the ONS file. If the same Urincicator is not 
used» the output recerd is Suilt Cand any olark after cperations 
donned» out the record 1s not written to the tile. 


it 18 important to note that SMS files are accessed dy openings 
the database and that even though ali CAS files tn the progran 
may Be conditioned by Jrindicators which are off» the database is 
opened and any exceptions that might normally cccur at cpen time 
can still happen. | | 


U-indicators being off may still require a recemrpile cf the DASBL. 
program to prevent 2a VERSICNERRCR Cof dictionary) at Data Base 
open timee 


Since only disjoint data sets can oe specified on File 
GDescription Specifications» any emdedded data sets associated 
with a disjoint data set conaitioned by a Jrircicatcr are treated 
as having bdeen conditioned dy the same Unindicator. ALL 
Calculation Specifications and Qutpute*F cormat Seecificattons 
affecting the embedded data set should be conditioned by the same 
Urindicator as the parents aata set and are ignored if the 
Urindicator is offe 


ENTRY DEF INITICN 
uUL“Ue The specified external indicatecr 1s usec to 


condition the OMS file. 


Blank The DMS file is not conditicaned by an external 
indicator. 


Refer to FiIilL&E CONDITICN Ccolumns 7i-71) cn menmOMS files Cpage 
4°34) for more information on external indicators. 


72-74 These coluans must be teft blank for fMS files. 


Ae 


fe RKeference page 13753. 
Make the same changes to 13°53 438 were made to 1379 alove. 


Qe Reference page 13-54- 


Refer to the next to the Last oaragraph; the first sentence 
Shouid read “The taplicit TRENOS operation generates an end 
transaction with audit and no syncooint»s excect when the Lk 


indicator is UN in which case the imolicit TREND operation 1s 
generated witn no audits» syncoointe” 


9. neference page 13765. 

Delete paragraph ce 

lGe Reference page gr713. 

Under "MOVE OPERATIONS” insert the following paragraph? 

"Cecimal positions are ‘Saared.wher movin} dats from cne numeric 
field to another numeric fieid. For example» if X is 4 field 


with three decimal positions and Y is a field with 2 decimal 
positians» a move of igvetfli from X to Y witl yield 139.243 in Y."™ 
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ae <a a aa a 


2azis Introduction. 


The Mark 9e9 release of the ANSI 68 COBOL cemrmpciler contains no 
_ new tanguage constructse Corrections have beer made for problems 
found tn prior releasese | ? 


2222 Enhancements. 
QeZele 


The fotltowing proolems reported in tne Mark 8e3 System Notes have 
been corrected (the number in sarentheses refers to the number of 
the problem reported jin the Mark 3.2 System Notes)? 


@e Attempts. to create lidreary files when “"SCCIMAL@POINT TS 
COMMA™ 35 specified now work correctly Colt E9 77 SMLO 34). 


De “2 CUDE™ now works correctly C247 724"NS6555). 


ce A Syntax error will now be generated when the "SELECT 
OPTIONAL eee” clause is usec with a nonsequertial file 
CLISO3G “CHAFF AA). 


de The statement "OIVIDE ACS1+5S2) INTD 8€51-52) GIVING 
C(SlsS2) ROUNDED CN SIZE ERROR MOVE ZEROS TC CCS1+S2)." 
no longer causes an “INVALID SUBSTRING" C1273 89°HMOC28)~ 


@e A “DUMP™ on an eaited fietcac now generates correct code 
CL3Z°ZZEPTOME 731} 


fe The compiler will now syntax a special character tn a 
Procedure name (13732337 3HN1303). 


ge “SUBTRACT 1D FROM ZERO" no longer causes the compiler to 
farl with "FIXUP COMPILER ERROR" (135-338-0414 21). 


he The prodilem reported with a "G9 TC0 SEPENDING ON* having 
to have a comma after the last Ladelt name to generate 
ccde» was caused dy a "NOTE" statement ard was not a 
comptier error (€16°732879¢2214). 


be A Level 66 ttem followed by a level $3 item ts row being 
syntaxed C23—CcO~7IPL 285). | 


j- iInctusion of a second "FILE SECTION" 156 row syntaxed 
C2357 G5 9"TONGG 3). 


ke A datawname that is greater than 33 characters tong ~—1no 
Longer causes the comoiler to adort with “INVALID 
SUBSTRING™ C3L"C4i-Ceisi3). 
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tl. A DIVIDE with a norwsianed result field row iyjives a 
correct remainder (32°75 737001125). 


Me A compiler error nessaje is now generated if the tLimit of 
255 terminal oerforms or unigue exit points 15 executed 
C43°7577°CNS9G1)~ 


ne A program using ISAM Fi 
cases with a "NO PRCVIS 
records have been 
Colw244rg5c275).- 


es aonormally ternirating in some 
ON FUR EOF" on the Tag Fite after 
added has been corrected 


l 
i 


Oe A Syntax error 1s geéener3ted if an asterisk is placed In 
column 8 instead of cotumn 7 €617244°°5°779). 


pe “DIVIDE A INTO 3 SIVING ¢& SEHAINCER C" now puts the 
correct remainder tin Cf €11°7688°99235%71). 
2232 lLemogorary Documentation. 
Qe3el2e When the Compiler Produces No Listirgs 


if tne COUBDL compiler comes to an adDnormal encwtaf"job and =~*ono 
source Listing is produced» there are certain steers that can be 
taken to find a temporary solution to the procolen. 


The first step is to determine the statement or statererts in the 
COSCL source which cause the prodlenme The *WLISTP* dollar option 
causes the compiier to list the source itnages tn the initial 
passe trrors detected in that pass are listed as they occure As 
the source tmayges are Listed» a sequential nuabder is printed an 


the teft side of the tisting. This numder ts used by the 
compiler to reference scurce inagese In some errers that are 
printed» this number witt atso de printed and will be caltead 
"TICARD*. This number can then ce used to find the source 


statement that 185 In error. In a CUMPSANALYZER Listing of the 
compilers» "TCARD™ will apoear as the first item with a bit length 
of 24 in tne "NAME STACK". Passes other than the tnitial pass 
will list other errors as they occur. The errors found using 
"Liste" Should be corrected» then the program should be 
reconpited. The "$3 TIME" option disclays the current phase of 
the compiler oeing executed ard is most Seneficial fcr deduggingese 


Whether or not a temporary solution 1s found» the praodlem Catong 
with all materials necessary to reproduce it) shcuid be submitted 
together with a Fieia Trouble feport Cform #1912623) cy the local 
Burroughs supgort perscnnel. 


4&3 


EXAMPLE: 


The following 18 a sample of cutput using the "$ LISTP™ option. 


aoe LPT is 
iS [DENTIFICATION CIVISION. 


09620 
goo2t 
80022 
(90923 


60625 
9626 


Oe 2 7 


98028 
e96829 


Syu221s 
Ne22eu 
vE2?"25y 
se/edebu 
2922 06 
O822835 
992298 
Gy23ny 
S02314 
OGca2e 
Ce2353e 
992345 
$u2356 
902 36¢ 


082379 


Gu238u 
002396 
5G 2466 


999998 
9359999 


ENVIS CGNMENT DIVISION. 
CONF icUuURATICN SECTICN. 


INPUT OUTPUT 
Coe 


VATA. 


eee 


SECTIGN. 


i? 


J-NAME 


Po x 


PROCECURE CilvIsiaNy. 


AP ARAG9 


nove 


APre 


A-LINE 


IF J7NAME = 
IF JwNAME 


if 


J*NANE 
IF JoNANE = 
LF 


iF J 
IF 


IF 
IF J~NAME = 


STOP RUN. 


END 


TF J-NAME = 
IF Jo 


TQ B-LINE. 
wi 
= no 
sh Pa 
a Sl 
Lae deus 


ME os 


NAME = 
JeNAME = 
J°NAME = 


wor 
wyor 
a EN a 
IF JNAME = "12" 
[IF J-NAME = "135" 
TF J*NAME = "147 
IF JmNAME = "15" 
IF J*NAME = 16" 


keke kk 
deeded tk 


ERROR 961 (FROM ONFILE) ON TCARD 
ERROR G6l (FROM ONFILE) ON TCARD 
ERROR 218 ON TCARD Cdl» COLUMN 


Cao2LL » 
C3SL1l» 


23 


COLUMN 
COLUMN 


te tk kk 


in trying to compile the previous examples the 
WEVALUATION/PROGRAM POINTER STACK OVERFLOW,» OS or OP" occurred. 
In taking a program dump» the first data iter in the Name Stack 
with a bit Length of 24 shows the vatue of TCARD to oe 27. In 
using this number to refer to the LISTP Listing it is fecund that 
the STACK OVERFLOW occurred while attemoting te orecess 32 nested 
IF statement which contained more than the atlowea nunoer of 
nested iF*s.. Correcting this coraition as well as the other 
errors Listed» atlows a successful recompilaticr. 


error condition 
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gedge222 Conngiter seneral infornation and Untinizations 


In order to achieve better utilization cf aemory on sralt memory 
size systens» the COQsSGL compitier has been imeclemented in a 


muitivwphase mannere In multitohase compilation the ortginat text 
1S transformed to a more convenient forn Dy passing it against a 
part of the compiler. The transformed text 13 then passed to the 


next phase via an intermediate work file. In this way the data 
is managed in 4@ somewhat sequential farner» mirimnizing randcem 
overlayinge Coge overlays ar2 minimized in the same way DSecause 


only a part of the code is tnvoked to transform alt the data for 
the phasee | 


Two disadvantages of muiltitphase compilation are: 


le if a large amount of nentory 13s available at compile times 
there 185 no way to comdine phases. . 
i 
2e A certain fixed overhead is required fcr opening and 
closing of the intermediate files» aven for an extremely 
smali source file. 


The CO8O0L compiler is divided tnto 12 phases» as folteus: 
de “PARSE™ = Initial Parsing. Merges source Languaae 
inputs» creates or copies library files» creates report 
file» scans ingut and writes tekens te ONFILE and 
ALLONGUT for further ocrocessinge 


2e "DICT*™ = Dictionary Processirge Builds a agictionary of 
all declared datat*names and procedure nanes. 


30 “ONQUAL™T = Datawname Qualification Resoluticne 


4e "LQUAL™ - Label - Cprocedure-nane) Qualification 
Resolutione 


Se "MERGE™ ~- Comdine constant information adout each 
data™name and procedure "name with a unique occurrence 


number. | 
Ge "DATSYN" = DATA GIVISION syntax checking. 


Veo "EXPLODE™ - Expand tokens in the PROCEDURE SIVISTION to 
include ail known attributes for that tcken. 


Be "PROSYN" = PROCECURE OIVISION syntax checkirge 
Qe "COOCGEN® - Code generation. 


1G. “"FIKUP" = Produces a codefile (the executsaale object 
| code) and a listing. 


When designing a compiler for many memory size configurations» it 
is important to effectively utilize additional memory if it is 
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avatlable. The CUESL compiler accomclishes this dy raraging the 
dynamic memory allocated at concile time. 


A certain minimum dynamic memcry 15 required for ouilding Lists 
and tables during the different phases. Associated with this 
minimum memory are various Limits Cfor exanrcles the numder of 
data~namnes» procedure™namne2s-e and so forth). lf a particular 
Source program exceeds any of these Linit3» more sface must ~23e 
dedicated by increasing the dynamic memory and racemrpiling. An 
attempt has oeen nade to nake these restrictions “reasonabie”. 


If additional dynamic memory is made available» the compiler Is 
designed to use that space for a significant speed saine Some 
detaiis regarding the use of dynamic memory may 3e found in the 
fellowtng paragraphse 


The dynamic memory atliocated to the CO3GL compiler is used for 
many thingse For the purposes of this discussicrs "text space” 
15 defined as the space recuired to store a datamname» Literals 
or procedurawnanee For example» the text scace for the datatname 
"MASTERTFILE* ais 11 bytes. some cf the uses of dyramic memory 
and the amounts required are as follows? 


le COPY eweee REPLACING A GY 3” pairse. Fach data*name or 
literal requires its own text space» plus 9 oytes per 
2e Mnemonic names. Fach nane requires its owr text space 


plus 3 by tese 
3e Data names. Each data-name declared recuires 38 bits. 


4&» Procedure nameSe Each procedure name declared requires 


Se Condition names. Fach "84" vatue List requires its own 
text space olus 7 bytes» olus an adcditionat 5S bytes for 
each separate literal tn the "VALUE" List. 


6e MONITOR. Fach dataname monitored requires 42 bits. 
Each procedurenane monitored requires its cwr text space 
plus 3 bytes. 


fe Library ftlese Creating or copying Liodrary Files 
requires 486 bytes. | 


Se Dotlar options. "VER GE™ and "NEW" aacn ragquire 486 
bytese "LISTP"™ requires 326 bytes. 


In order to minimize the intermediate file sizes» information 
adDout the original text is distributed to several files which are 
ordered to each othere The individual files are then processed 


without the need to copy extraneous informations. When atl of the 
transformations are complete» the files are merged. 
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The following List orovides some general inforraticn abdout the 
files used and created by the compiters such as internal names 
external name» device type» ohases in which used» access types 
open type» which systen drive directed to» and fcurpcse: 


Le NEWSGURCE "COCSGLW/SGURCE* OPTIONAL DISK 
Created by PARSE. Contains source card intaces to which 
patch cards have deen arppliede  Sequertisat access» 


GUTPUT. Siraected to system drive i» 1f possible. 


2s LIBRARY "COBOLW/LIGRARY*™ UPTIGNAL CIS 
Used DY PARSE to create or reac library files. 


sequential access» INPUT and CUTPUT. Cirectéed to systen 
drive l» if possible. | 


3e CARDS *MCAROS™ READER 
Used pby PARSc. Contains source card images or patch 


cardse Sequential access» INFUT. 


4e SCURCE "CUBOLW/SOQURCE” OPTIQNAL DISK 
Used ody PARSE. Cortains source card inaces to which 


patches may be apptied. Sequential access» INPUT. 


Se REPORT PCOSOLW/REPORT™ CISK 


Used ody PARSE CCOUTPUT) and FIXUP CINPUT). Contains all. 
card images processecs» includirg dotlar cards» tiorary 
cards» and patch cards. Used to print the listinge 
Sequential access. Directed to system drive lL» if 


posstdte-. 


6e ONFILEX "COSOLW/INFILE™ | CisK 
Used by DICT» ONGUAL» and L&UAL. Contains ail oicture 
Strings and variables reduced to an cccurrerce numdere 
Also used Oy MERGE and fATSYN to cortain an entry for 
each unique picture string of the CATA DIVISION. 
Sequential accesse Directed to system crive  l. 


fe SEGFILE © ~—6CUBOLW/SEGFILE* DISK 

7 Used by MERGE» DATSYN» CODEGEN» and FIXUP. Centains edit 
masks» values to which the WORKING "STORAGE vartables 
should be initialized» error or warning messages and 
Various other information which is used te bButid the 
codefile and supply additional data for the Listing. 
Random accesse Directed to system drive oe 


Se LINE nL INE PRINTER 
Used by FIXUP for Listing» or Sy any phase fer compiler 
debugging output. 


Je ADNFILE "CUBOLW/ADNFILE™ | DISK 
Used by MERGE» CATSYN»® EXPLODE» and PROSYN. Contains 
merged tokens of ALLUNOUT and ACFILE. Sequential access. 
Directed to system drive i» if possiblee | 
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lee ACFILE "Cotolw/aceiite* CISk 
Used dy PAKSE» Bilt» JONQUAL®> LGUAL» and NERGE to contain 
picture strings and all variadie names isclated (Cfor 


examples section names» paraygraph*naness» anc catatnanes). 
Also used Dy CuSeCEN and FIXUP toa contain exntlicit 
Csrocedurenanes) anc implicit Cconacttlervwgererated Oranch 
points) Label attributes used for generating tne correct 


Granch acdressese. 4lso used dy EXPLUDE ard PRusYN to 
contain tokens which have Geer exsarded to incluae att 
the known attricutes for that tcken-e Random accesSe 


Directed to system drive 1» if possidle. 


lie ALLONUUT "CuURPILW/ALLONOQUT™ GiSA 
Used Dy PARSE ang 4EnGE to cortainr ait constant 
information accut ¢32ch token pracessede Also used Dy 
DATSYN and EXPLOVE to contain en entry for each axplicit 
data~name Cexcludina FalLif entries). Fach entry 
contains attrisutes such 45 usadte»r address» Length» 
nuader of suoscrivts raguired» ani so forth. Also usag 
Dy PXUSYN and COVESEN tao contair tokens tnat have oe 
Syntax checked» rearranged» and simolified for code 
generatione Random access. Uirected te system drive tl» 


if possiole. 


l2e cOdDEFILE "CCSOLW/COOLFILE* Cisx 
Created oy FixUP. Contains the oSject program according 
to MCP specifications. Not created if syntax errors are 


detected. Random accesse Directed to systenr drive g. 


If the system detrng used fer compilation does not nave muitiole 
System drives» those fites which are cirected to systert drive 1 
can ve mnodified to reside on 3a user packs» if one ts available» to 
achieve Better disk utilization. 


As a general ruies the most effective way te ootinize cdO3zoar 
compiles 715 to utilize aynanic nemory to minimize cisk accesses. 
For several phases where sufficient dynamic merory to wnaintain 
infornaticn in memory rather tnan on disk 18s atlocatec» files are 
loaded into tables and accessed» rather than randomly accessed on 
diske As a resuits» comoile tines can Oe significantly reduced. 


in order to determine whether the Lasels are being srocessed in 
memory or on disx» the dotlar ootion card "TIME" car 9328 used. 
This option causes compile statistics to De printed following the 
normal compitation outpute The fields catted EXPLICIT.LAPELS and 
EXPLICIT.DATANAMES can 3e -aultinplied dy the ancunt of memory 
required for each to determine the rininurm arount of dynamic 
memcrye | 
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je 505-5 «= Use of the ISAM Attributes. 

when a disk file is first created COPEN QUTPUT «2. CLOSE LOCK)» 
four attrioutes are fixed and cannot be changed until the file is 
recreatede These are: 


RECORDeSIZE C852) 

RECGROSe3LGCK C8.5) 
BLOCKSsAREA {(5eA) 
AKEAS CAR o£) 


The maxifium number of records that car be contained in tne file 
can de calculated as: 


Maximum Records = R26 * 82A ® ARE 
é 
All of these attritutes can 092 specified 2y the presrammear via 
the "RECORD CONTAINS» "WELOCK CONTAINS%» and "FILE CONTAINS" 
clausese For ISAM files» the compiter jenerates two files for 
each [SAM “SELECT” clause Cthe data file ana the tag file). The 
programmer does not have any direct centrol over tha attridutes 
of the tag file. The compiler sets the tag file SECTURD.”SIZE to 
the size of the record key nlus either 3 BSytes Cif $$ RPSTAGS 15 
specified) or 4 bDytese The RECOROSe FLOCK 35 calculated to get a 
Dlock size of 18€ bytes or less. The AKEAS 45 set the same as 
that of the data file. The =ELUCKS.~AREA 15 set te iIrsure that the 
tag file can hold as rany records as the gata fitee For exanple: 


TWBeA=COTR~AS*OTEeADSToORAStCif any remainder then i else 3) 


where "T-" means “tag file™ anid "D-" reans “data file”. Extreme 
Caution shouitd de used when changing any of these attributes via 
the “MODIFY” or "FILE" statements. if the data fite 1s changed» 
the tag file must be chanced correctly. 


2es242 JSAM Eile Recovery. 
When a record 15 added to an {5AM file>» the conpiler must 


generate code to do two WRITES» ana to the tag file and one to 
the aata file. This a immediately brings up some potential 
problems in the event of aonormatl job terminaticn. 


Currently the code generated by a RANDCY WRITE is as follows: 


de WRITE the tag record. Jo not recuest any error 
reportinge This means that any error on the WRITe 
CParity» incomolete I/d» Full File) causes the MCP to 
terminate the program inmediatelye 


2e WRITE the data record. Request error aaa at in the 
event of an errors the program takes the INVALID KEY 
Drancn or invokes the sapeppropriate USE routine. 


The above code sequence could resuit tn the tag file having a 
record that pcints to a nonexistent record in the cata file. 
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In the WRiTt of the data files» the error reoerting requested and 
action taken depends on the prasence cf an INVALID KEY statement» 
a USE routines or doth: 


Le INVALIC KEY ™ Report on ESF CFull Filed. Return a status 
of 16 Csnould se 24) and take the INVALID KEY Oranch. 


20e USE Routine *™ Resort on Parity. Return a status key of 
12 (should be 34) and enter the USE routine. 


Se INVALID KEY and USE Routine - Report or FIF or Parity. 
If Parity» return a status key of $4 and arter the use 
routinee If £ECF.e return a status key of 1: CUshoula be 
24) and take the INVALiS KEY brancn. 


If an error _ceccurs and reporting cf that error has not been 
requested» the McP terminates the oprograa with the following 
message: 


NG PROVISION FOR <error> tN FILE <filewname> 


If the fatlure occurrega Satween the wH2iTc of the tag record and 
the WRITE of the data record,» the EcFAPOQINTERs en the two files 
are differente Two choic2?s are availabie at this point: either 
reload both files or copy the Larger file Cdiskwttavdisk) Leaving 
out the extra record Cfor example» use DMPALL with the INCLUDE 
<EQF.ePOINTcCR = 1> optione If the EUFePCINTERS are the sane» the 
only problem 15 that the tag file has not been sScrted. It is 
therefore possidle to sort tne tag file Cusing the s0RT utility 
program) and continue processing. 


It should ode noted that 1f corrusticn occurs and ro recovery 15 
effected» the next program tc use the file may not detect the 
errore The only check made ts during the duilding cf the rough 
table CACCESS MOOSE IS RANDOM or START t85 used)- The racords read 
in buiiding the rough tattle are sequencedcheckec and a fatal 
error occurs in the event of 2 sequence errore Honeverse if the 
few records read by the “build rough table” routine are in order» 
or no rough tadle ts built» then the program proceedse In this 
cases records that are present may not Be found and duplicates 
may be introduced. 


COack checks for duplica key values at the time a WRITE 
Statement 15 executed. The compiler generates code so that 
before each RANDOM WRITE the file 1s searchea for duplicates. If 
no duplicate is found the record 15 written» but if the record 
already exists in the file» the INVALID KEY orarch or USE routine 
is taken with the status key set to 22.4 : 


325234 Efficient Use of ISAM Zonstructs:. 
te 


AS an example» assume a simote file nainterance cregram that 
accepts “add"» "“change"™*» and “detleta™ records. In CdBoL the 
efficient way to handle this case would be to do 4 *keyed”™ read 
only if the record type is a “change” or “delete"™. if the record 
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type is an "add"™» then deo not do a RcAD; do a wsilTE with an 
INVALAD KIY statement and a STATUS KEY clause. If the record is 
a duplicates» the INVALID “LY oranch 18s taken and the status key 
1s set to a 226 This allows only one search of the file Cinstead 
of two) to be performed for each "*add"-type record. 


CO30L has two methods for creating an JSAM file>, either Sutout 
ordered (sequential) or Random. It -ais net pessicie to 
sequentially write an I5Aé™ file with the recoras unordered. 
Uniess care 18 taken» this may resuit in programs that run 
extremely slowly» as described in the following exantplas. 


The first example deals with a "loac™ of an 154M file from an 
unordered source. if the fila is openeg JUTPUT with an access 
mode of RANDOM» the program runs very Slowly. AS e€acn record 1s 
written the ISAM routines must check for 4a duelicate record in 
the file Cnote: an optimization has Seen incorporated in the 
ISAM routines where the check for duolicates 15 not acne if the 
record to 92 added 15 greater tnan or less than any recorsa 


previously added). If the file 15 cCeing written in a randon 
manners» before the nth record 18 writter» the rwi oravicus 
records must de read. In the worst Casep the addition of on 
records can result in ?n writes (tag ard data) and the summation 
of gn =m where m varies from 2 to n readse for examples the 
addition of 6 records could take 12 writes and 4+24+241 reads. 
This can obviously be a very stow process fer large files. Fer 


large files» it is much Detter to first sort th2 tnput file and 
then do sequential writese 


The second example involves renoving certain records» flagged as 
"to be deleted"s» from an existing ISAM file. The best method of 
handling this 1s to open the existing iSAM fite INPUT SEQUENTTAL 
and open a new ISAM file BUTPUY SEQUENTIAL» then READ and WRITE 
sequentially. The READS may cause same disk arm mevement if the 
data records are randoms but the WRITES will Be very fast. This 
method gives the added advantage of ordering the data records in 
the new file» providing faster access in all future sequential 
access CaseSe 


323282 ISAM Subroutine Seatentation. 

The CO80L coapiter automaticaliy segments the [S4M-generated 
filemhandling sudroutinese The seamented subroutines start in 
the first segment higher than the highest user segment. For 
example» tf a program has user segmerts "Je Ls» 2 anc 3" and two 
ISAM files» then the [SAM subroutines ares in seqmerts 4 and 5 
If the orogram also nas exponentiatiors then the *expenentiation"™ 
sudDroutines are Located in segments 56 and 7? (Cthe two highest 
segments generated). 


2esefls soecifying the TVALUE YF CuURETINDEX*. 

The specification of “"integerw1" in the "VALUE CF COREINDEX" 
option is in *oytes”". If the value specified is too snatl» then 
disk activity increases and throughput dacreasese tf the value 
specified 18 too tiarge» then nemory is wasted. There are several 
calculations necessary before an arbitrary value should o9dea 
assigned. These calculations are in the format shnowr tn the 
following formulas: 


Rough tacle entries = CuURESINIEXK Ss REC ORO-KEY.~Sil2e 
TAGeRECORD.-SiZe = RECURD.AEYeSiZE + Cif S$ RPGTASS then 3 alse 4) 
TAGeRECURDS-sLOCK = 18¢ / TAGeRECURD.STIZE 


When the numoer of rough tabdie entries equals the nunber of tag 
file blocks» minimum disk activity is achieved to secura the tag 
record tnat nolds the key requestads~ The rough taste 1s Sinerily 
searched to find wnat part cf the tag file holas the kay. That 
partitton of the tag file is then tinarily searched {Cdy ranaonly 
reading the t3g records) until the record key is either foung oor 
1t can be determined that the requested key dees not exist. 
Therefore the optimum CURETINODEX ClLowest memory for the towest 
physical i/d activity) may te found as 


Optimum CORETINDEX = CTAG.EGF/TAG. RECORDS. SLOCK }*RECGRD. KEY. SIZE 


Increasing the CORETINDEX SGayond this value Cup to TAGeEQF * 
RECORDeKEY~SIZE) wilt reduce the numoer of Logical I/O 
operations» Dut wili not decrease the number of chysical I/0 
operationse Increasing the CUORETINCEX further wastes nemnory. 


Example: 


FILE CONTAINS 36 BY 542 RECIRDS 
ELOCK CONTAINS 6 RECORDS 
RECGRDeREYeSIZE IS 4 SYTES 


Assuming that the file is fulit (CTAS«ECF=19445 )» apnolying the 
previous formulas results itn the following: : 


8 pytes Cno 3 RPGTAGS) 
22 
$253e aytes 


TAG eRECECRD.WSTZE 
TAGeRECORDS.~SLOCK 
COptimusn COREmINDEX 


ot 


If allocation af 3532 oytes for the rough taote is considered 
excessive» the following formula may De applied to cecrease the 
$size of the rough table and still achieve 3a high degree of 
efficiency: 


New CORE-INDEX = Iptimum COREL NDEX/((2**nd-1) (rcunded uo) 


where "n" varies from 2 Dy 1 until the new CORETINGDEX 


is an 
acceptadle value. For examples if 3532 is too much» then div 
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Dy 25 giving i178. Tf this ts stiil toc highs civide by 7» 
giving 5u5» and so forth. 


aesede NOIStTHORDS ang their imolicaticnse 7 
The following i185 & list cf words which a&re tgnored by the 
compiler known as NOLSEewORTS: ; 


ACVANCING FOR SENTENCE 


ARE KEY STANDARD 
AT KeYS THAN 
ALTO , MANUAL WITH 
UieMAND ON 

is RECORD 


The misspelling of 4a woradg such that the resultine werd is a 
NOLSt“WOKOD>» results in tnat new word CNOITSE“wORD) Setrg omitted 
Dy the scanner for the coapiler. For examples, the misspelling 
of the word TUF" as "UN" in the following statement results in 
Doth data names receiving the contents of *DULLARTAMOCUNT*: 


MOVE DGLLAR“AMOUNT TO AMOUNT O88 AMT*GROUP. 


The foilowing example shows that the "iF ™ condition is true onty 
when KEYi is less than 8 instead of being true wher KEYI is tess 
than WEY: 


IF KEYL < KEY &» GO TQ WRAP-UP. 


The use of contractions of key words as datactnames is NOT a good 
practice» however» careful desk checking and screerirg of source 
code for nisspelling of NQISE*WEORGS can Save hours of 
DUMPTREADING. 


wee ines ee oD a “a “aa eh pce aa an ae EE An aD ae: ae} > “he a ome wm ah ee oe 


The COBGL Cross Reference Utility Pregram (CGBCL/AXPEF)» accepts 


as tnput a syntactically correct CoOsCL source program» and 
depending on the option selected» outcuts a cress reference 
. listing» or 4 progran source tisting only» cer beth a cross 


reference and a program source tisting.s 


The source program may reside on disks magnetic tare» or punched 
cardse The following is an examole of a Ccoe8LRL/XFEF execution 
card deck. 
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42 END 


4? EXECUTE i 
COSGL/KREF 1-7 


COSOL/XSEF Execution Deck 


The oaption entry specifies the location of the source medium and 
the outout desired. delow is the format of the CO38CL/SXREF cotian 
carde 


 meeerers= col. 2 Sees COLe. -f 
L \ 
: | 
\Coption] \Ce] 


The option entry nust Degin tn column 1- 


The C denotes that the COGSCL COPY verd 1s usec withir the source 
programe Cs» when used» ‘must 3e In coiunn 7. Requested liorary 
files must reside tin the disk directory. The libdrary secuence 
numbers. within a source program are indicated by an Ll te the teft 
of the sequence numbder. 


The options and their descrintions are as follows: 


CAKD The input source program is ounched cards. Produces a 
cross reference Listinge CARD is the cefault tnout.e 
If the option entry is onitted the input is assumed to 
be cards. 


COLIST The input source program 18 punched cards. Produces doth 
- @ S0urce program Listing and 4@ cross reference. | 


vISK The input source program having a file idertifier of 
CUOBULA/SOURCE resides on diske Produces a cross reference 


DKLIST The input source program having a file identifier of 
—EOSULW/SOURCE resides on disk» Produces Octh a progran 
Source Listing and a cross reference. 


LiIsTco 


LISTUOK 


LISTTP ®* 


TAPE 


TPLIST 
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The input source oregram is ounched cardse Preduces 
a source program listing only. 


The input source program 1s on disk» Produces a source 
proyram Listing only. 


The input source program having a file idertifier of SCLT 
tS ON Magnetic tape-e Produces a source orcegram Listing 
oniy. 


The input source program having a file identifier of SOLT 
1S ON Magnetic tape. Produces a cross reference Listing. 


The input source orcecgran having a file identifier of SOLT 
1S ON Magnetic tape. Produces BSoth a source program and 
cross referance Listing. 


Internal File Names 


Internal Fite © external File 7 
Identifiers Identifiers vescrioticn 
CARDS CARDS irout Source Cards 
TAPS SOLT | Input Source Tape 
DISKS COSOLW/STCURCE*® : input Scurce Disk 
CBXPRT XREFER Printer Qutcut 
*Refer to the CO30L Compiler dotion NEW for the creation of this 
file. : 
Examples 
Card? ? EXECUTE CUeCL/XREF Tapes ? EXECUTE COXOL/XREF 
2 DATA CARDS | 2? DATA CARTS 
CARD C | i TAPE 
Csource deck) 2? END 
? END | 
Disks ? EXECUTE COBDL/XREF 
2? DATA CARDS | 
DISK 
2? END 
NOTE 
if more than cne cross reference file cculd exist» the 


F 


ILE statement must be used to make each file identifier 


uNITQUe. 


oP 


Certain options of the CGRBCL“YXREF progran are cortrolledq by 


programmatic switches entered by the system opera3atcre Refer to 
the SW controt instruction attriodute and the Sw INPUT MESSAGE 
keyboard input mwnessage for details. The options and «the 


orogrammatic switches and values r2aquired to cortrol the options 
follow: 


Switch Value Ootionr 

Saul . 3 Co not cross reference Literals. 

SwWl i Cross reference literals. 

SW2 3 Vertical soacing for tine crinter is to 


be 6 Line per inches 55 lines per page. 


SA2 | 1 Vertical spacing fer line printer 1s to 
de &@ Lines ner irchs 75 lines cer nage. 


Sw3 Q No copy files recuirede 
SW3 1 Copy tiles required. 
SW5 #) CARGe 

SW5. 1 . TAPE « 

S45 Z Gist. 

245 3 TPLisST. 

SWS 4. DXLIST. 

SW5 5  -LISTTP. 

SWS 6 LISTEK. 

SWS C Douole Spacee 


SW65 1 Singte space. 


Seles Introductions 


The Mark Jet release of FASIC 
constructSe 


contains 


no 


new 
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Language 
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is ER a A MERI GRY omen TR 


hark Sei release of FORTRAN contains no nen tanguage 


fe3e Temporary iscumentation-. 


fejels 

The following 1s a description of the capabilities for using 
remote files in surroughs Standard FERTKAN (CANSI 56). The 
examples given assume th2 use of a TlSice Screen formatting on 
other terminalis may reguirs tne use of other coces depending on 
the firmware of the terminal. 


Burroughs FORTRAN permits the declaraticn of a remote terminal as 
a hardware tinout/output device. the following is ar examole of a 
FILE declaration statement to declare a tarmiral as remct2e 


FILE 8=RMT» UNIT=REMOTE> RECORD=192" 


Only one remote file can be dectared tn a FORTRAN oregrame The 
entire screen Cor any part thereof that is dectared ir the fite 
deciaration) is considered to 3e ane record. The maximum size is 
L920 characterse The record 1s written with 38 characters on a 
liane (barring any carriage control characters de Wher the end of 
the line is reached» output proceeds on the next Lire. 


Example: 


WRITE (C8a100) CilId eJ=1-129) 
104 FORMAT CiusaA2) 


The preceding example takes the first 2 oytes Cafter the 4 obits 


of type information) of each cf the first 190 etlemerts sof array i 
and writes them to the remote terninal. 


Executing a program that has a remote file dectared ard opened 
requires the following: . 


a@e If the user 15 signed on to an SMCS» the following string 
1s entered: | 


EX <orogramn>/<namne> 
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Oe If tne user is signed on to CANOE» eaxecuticr proceeds as 


follows: 

EX Execute the workfitle'’s cbject orograme 

cr 

EX <name> Attaches the usercode tec the unique namee 
or 


EX <fanily>/<nane> Comptete nane of program tc be rune 


Since .a file is not opened until the execution of the first data 
transfer statement CREAD» ARiTes atce)» a WRITE statenent shoulic 
be executed oefore any input from the teratrat to irsure that the 
file is opene if this ts not done» the user may erroneously 


think that tnput is DdDeing supplied to the FORTRAN programe when 
it 31s actually bdeing supplied to CANE. 


A convenient method for sencing screen formatting characters to 


the terminal 1s through the use of hexacecimal data 
Intttalization. Hexadecimal constants» which aay anty  5e 
asstgned tn a OATA statement» are assigned tc the variable 


Without conversion or regard to type. 


DATA HOME» BLINK /Z39CGOC9lOG> ZILETENCGI/ 
DATA BRITE» RS» LF /Z53FO26GGb» ZOLES COtGe ZE25cudGe I~ 


>¢ 


The user must remember that the first four Sits are type D1ts and 
are stripped off before transnission to the screene This is why. 
the first byte of each variable 1s % in the above exanpte. 


The fotlowing. is an example of how to write using screen 
formatting characters Cassume the pecaras contains the previously 
given examples): 


WRITE C6100) HOME>» CLF, I=lelld» BLINK» BRITE» RS 
1G6¢ FORMAT CLZ2AL>» 38X» ZAl» "THELP'»s Al) 


The above example sends the cursor to the home position and 
ciears the screens then skips to the izth Line cn the screene It 
then skips over to column 39» prints HELP with the bright and 
blinking highlight characters turned cn» and then terminates the 
highiighting with an a5. 


More than one formatting character may be given within a 
vartable. If in the example adove we also have ~ 


DATA BLBR /ZC0183F52LC/ 
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as weit as the rest of the variastes» the WRITE statement could 
Look Like the following: 


WRITE CSel035) HOME> CiCdU)» J=Llol1l)d» SLERs RS 
109 FORMAT Cl2Als> 38X» A2»y "HELP s Al) 


Notice tne only change in the FORMAT statement 15s A2 instead of 
Z2A1l. : 


To put the screen in forms modes» the following characters must de 
transmitted to the screen: 


CATA FMGDE /2Z827Eo3 Sts 
WRITE €82156) FMOSGE 
1G0 FORMAT (€A3) 


The forms delimiting cnsracters fotlow. 
CATA US» RS /Z91Fstd0o3» ZILEL eae s 


for more information on the use of forms characters rafer to the 
TO83G manuals» form number 1295768. The following is an example 
of a program that writes these forms characters and then reads 
fron the field they delinit Crenemver that a READ in forms mode 
ontiy receives the information contained within the datimited 
fields): 


WRITE C3193) US» RS» FMODE ° 
190 FORMAT €37Xe» Als 4X» Al» AZ) 
READ C3205) 1 
2UG FORMAT C14) 
STOP 
END 


The above example puts a 4 character forms fielc in the middle of 
the top tiner then puts the screen ir forms tode {(rothing should 
follow the characters that put the screen itn forms mode) 
returning the cursor to thea beginning of the field. More than 
one forms field may appear on a screens Transmitting from the 
Deginning of the first forms field transmits alt irfermation in 
all the forns fields. 


The foitowing ts an example of a program usirg most of the 


features of remote FORTRAN. Tt writes a messace te the screen 
and receives input ¥n forms mode. The input is ratransmitted to 
the termiral in the middle of the screen. Twe fields fer input 


are givens ooth accepting information in A format (character). 


€- 


FILE 
FUILE 


ity 


J=RKEMOSUNITSREMCTE »RECORC=H1 920 
B=SPOe°UNIT=SPC0 

IMPLICIT INTEGERCA-Z) 

CATA HUME SREVeFMOCE pUS ae A565 eC RSI ZIT EDEL ee LG 
#Z9 27066 3G ao 7 TTF CG SG8S ae ZELEL SUT 342 258 oe 
UATA SLSR/Z0i1a3F 2021/7 

ARITE CFeLCSDROME pUS er RS eUSe RS oF MOTE 
FURMATCAL® 25% sALe GX oAL SLI OX oALe AX o> ALP AD) 
READ €39e9290) Tod 

FORMATC2A4) 

WRITEO Fe 305 JHOME o> CCR oe NRL oLLD PEL SRe REVe Te RS > ELAR J 
FORMATCLICALS S6EXeA2Z PALS Ado AL DAZ» AG) 

STUP 

END 
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S82 UPL 


Beie Introduction. 


The Mark 9e3 version of the Url comoitler irctudes corrections toa 
outstanding problems fron the “ark 8-23 version cf the UPL 
compiler. © These corrections are documented tn the following 
paragrapnse 


Begs Enhancements. 


BeZele 
The UPL compiler no tonger generates incorrect code when a 
substructure 1315 missing from & dummy declaration. The syntax 


error "SUsSTRUCTURE MISSING FROM CUMMY CECLARATION™ 35 £4ganerated 
instead. 


Se2eces 

The UPL compiler now displays the following warning ressage when 
the "&8ENO" statement 5s missing from the source file and the JYPL 
compitier reaches end of file tn the source file €13°378°SWH179). 


"MISSING ZENO” 


This caused problems because conditional compilaticn olocks were 
not terminated. 


Be2e3 | 
The UPL compiler now generates a syntax error when the statement 
ot the following form is specified In the Source (file 


COLL 75°01 919d. 
DECLARE (A»B8sC) FIXED; 
A 3= "6 22 C s= 1% =%&%& This statement 1s invalid. 
The following syntax error is generated. 
ADDRESS REQUIRED: ASSIGNMENT TO A VALUE TS NGT ALLCWED 
S22she 
The default file type for a file declared in a UPL orcgram is now 
"DISK". The default file tyce was "TAPE™ C1i3“338"DE1CUG). 
Beleds 


"CO" blocks can oe now nested 32 Levels deep without requiring an 
identifier immediately following the word "C0". 
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22226 e ) 

The UPL compiler no Longer generates Incorrect cede wher the 
"t FORMAL CHECK" option is used. The UPL compiler used to 
generate incorrect coce for fermalt parameters of type varying 
C61°709°GU9592). 

Belels 


When the UPL compiter is compiling a lLiorary rcutire that is not 
a sequenced Libdrary file and a status request was artered to the 
UPL comotler» the UPL compiter used to rescond with 
"SEQ <8 Dianks>™. The UPL compiler now rasrconds with the current 
line number within the tibrary file if the current source image 
does not contain a sequence numder C137 3387AL SHC). 


gelebe 
The UPL compiler no tonger responds with a reference te "SOL" In 
response to a status inquiry. 


s2s2s | 
The following warning message was granmatically incerrect when an 
underscore €_) character is us2d in the internal file nane: 


PUNDERSCURE REPLACEDSY PERIOO IN INTERNAL FILE NAME" 
The warning message now reads: 
WUNDERSCORE REPLACED 3Y PERIOD IN INTERNAL FILE NAMES 


Belelte | | 
The UPL compiler now writes the syntax error message ta a file 
labeiled "ERROR-LINE™ printer when Program Switch 1 of the JPL 
compiler is equai to 1. This allows users of the "CANDE*™ orogram 
to easily retrieve the syntax error and warnirg messages on their 
terminal without having to List the complete source Listing. 


Bs geile 


The UPL compiler now generates the following syntax error message 


when the "SVOIU" compiler option 1s used and the terminating 


sequence field number 15 not exactiy 32 digits. 

PSEQUENCE NUMBER MUST BE @ DIGITS" 
Becelee | 
The UPL compiler used to generate the following syntax error 
message when patching a format declaration in a recompile. 

"PARAM MISMATCH BETWEEN FCRWARG ANG PROCEDURE” 
This syntax error message is nisleading. The UPL compiler now 
generates the following syntax error nessage fer the same error. 


in addition to the previous message. 


"CANNOT PATCH LEXIC LEVeL ZERU ON RECOMPILE* 
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BeZel3s 

The UPL compiler now correctly checks the source fila when a 
"CAT" operator 15 usede The UPL compiler used te cencatenate 
multiple source tines together. Concatnation between source 


Lines 18 tnvalide 
Example: | ° 


GeceLlycs "FIRST * CAT cent oe CAT SEINE 
COSC 25G0 MSECOUNO 7 CAT "SUURCE * CAT. “Line” 


The UPL compiler used to concatenate the two source line together 
to produce "FIRST SOURCE LING SECOND SOURTE LINE"™. The UPL 
compiler now generates a syntax error m2ssagee6 


Gees 1 Ase 
The UPL compiler now terminates a compiie with a syntax error i f 
the "CREATE_MASTER” option is specified and not specified tn the 


first source line. The Url conpiler used to terminate without 
any syntax errors and removed the existing source file. 
e 


The UPL camptler ro tonger converts the period €.) character to 
the underscore C(_) character when the pericd (2) charactear 
appears in a string delimited dy the quote mark (") character. 
Alsc» the UPL compiler correctly converts the period (C(.) 
character to the underscore (€_) character when a cuote nark €") 
character 15 missing from a stringe 


8222162 
A UPL program no longer terminates oe "NO EGF PROVISION --0S OR 
DP™ when nonitoring procedures at runtime. 


B222l7s yg 
The UPL compiler used to generated the following syntax error 


message when a semicolon (+) character did not follcw a crocedure 
end Statement. 


"IDENTIFIER MUST FOLLCW PRUCEOURE™ 


The UPL compiler now generates the following syntax error 


"MISSING SEMICOLON" 


The UPL coupler terminates the compile once this error is 
detected. i 


BeZelts 

The UPL compiler now correctty recognizes the word “THEN*® 1f it 
appears in the last four columns of a source Line and the next 
source Line contatns a ampersand €&) character ir cclumn one. 
The word “THEN” was previously ignored. | 
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BeZelSe 
The UPL conpiler no Longer termtrates with 
WINVALIO SU3SCRIFT - CS CR CP* when a aqucecte (") character ts 
missinge 


825- Temporary Jocumentations 
Bedel- FIND DUPLICATE CHARACTERS. 


ED ONE GE <P GED ee Ge ene ED wee GD EP ce OR ee ee SD ie <  - -c ee ~oe 


Syntax of the Coamand: 
FINU_OUPLICATE_CHARACTERS Cc<refestring-1l>»<court>s -"=7> 


A auplicate character is defined to be three or more contiguous 
characters that are identical> thus "AAA™ ¥5 a strina containing 
gquoplicate characters» while wAA contains ro duplicate 
characters. 


The "FINS DUPLICATE_CHARACTERS”™ operator scars the text of the 
String referenced Dy refrstring7l» Looking fer duplicate 
characterse If a string cf duplicate characters 1s founds 
scarning continues until the 2nd of the string cf duplicate 
characters 1s reached. The operatcr returns the following 
values. 


refestring 71  " "modified to reference the sudstrirg that was 
not scanned? thus its first element is the 
character that Immediately fcollcws the 
dupltcate character string. 


count | --the number of duplicate characters found. 

character “—-tha duplicated charactere 

ref-string~2 “ereferences the substring that was scanned 
before the duplicate character string was 
found. This substring coes rot contain 
duplicate characterse | 


NOTE 


Ref-string-1 and ref-string-2 must both be 
reference variabdlese 


€5 


Examples 


DECLARE STRING CHARACTER(21)> 
REF __STRING_1 REFERENCES 
REF_STRING_2 REFERENCES 
CHAR CHARACTERC1)> 
COUNT FIXEDs 
STRINGZ="TH1IS IS THE PLAAAAACE™S 
REFER REF_STRING_1 TO STRINGS 
FIND _CUPLICATE_CHARACTERS CREF_STRING_L» CUUNT» CHAR> 
REF_STRING_2)3 


"FIND_DUPLICATE_CHARACTERS”" would set the following values: 


REF_STRING_1 = "cE" 

COUNT = 5 

CHAR = "A" 

REF STRING 2 = "THIS I5 THE PL" 


23222 important Segments. 
Syntax of the Command: 


SEGMENT (<segmenttidentifier> ~ ttt ett ttt ren steer tenes 3 cen eennt 
! 
I-- » IMPORTANT =~! 


DEGMENTPAGE SSG ment=10en tit ier Tea a eS AS See SSS ee eS 
im OF <pagemidentifier> 1 


1 . a” 
fm~ » IMPORTANT =] 


The "IMPORTANT SEGMENT® construct is an extension cf the UPL 
“SEGMENT™ statements» which divides a program's object code into 
overlayable sectionse In UPL» the crogrammer must exolicitly 
segment the prograsa if overlaying is to be allowed, if xno 
"SEGMENT" statements appear» the entire osrogram ts comnpiled into 
a single segment. Runtime mamory requirements fer a program 
should decrease when that program ts segmerted» od¢€caguse not alt 
segments must dpe resident in memory simultaneously. 


dhen a progran references a nonresident segment of code» that 
segment must oe moved into main memory from disks If no memory 
space 1s available» tne newly called segment is written into the 
Space occupted by 3 Less Important segment. This process 15 
called “overlaying”. The "IMPORTANT SEGMENT" construct gives a 
segment som2 orotection from being overlaid. 
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xefer to volume 1 of the Software dJperation Guide (form # 
1198982) for a discussion of the Memory Management Systeme 


The decay factor field (See Memory Management cdiscussion) in the 
code segment dictionary is three bits Long» dut nay have only one 
of two values**zero (Calldt3iad)d for unimoortant» or seven 
Ce€izsililad for important. The MCP uses the direct cemcplenent of 
the decay factors thus» In 32 menory dumo» a decayfactor value 
of zero means the segmert is tmoorteant» and 3 value of seven 
means 1t 15 not important. The actual decay~"factor assigned to a 
segment 31s stored in the memory Links» and is Labelea Cin a dump) 
as .the tncoming» or current interval decay factcr. 


Bejebe Processor lines 
The construct *PROUCTSSUR_TIVE™ yields the accumulated processor 
time since #UJ in tenths of a seconds the returrec value 15 a 


BIT(2C) data item. 
The following example iitustrates the use of this construct. 


BECLARE CPROC_TIME»HOURS »MINUTE S»SECONCS>TENTHS) SITC25); 
fx EARL Y CU ve &f 


PROC_TIME z= PROCESSON_TIME; 
¢* CQDE T C BE TIMED #7 
PROC-TIME := PROCESSOR_TIME - PROC_TIMES 
HOURS 2= PROC_TIME / 360993 | 
MENUTES <%= PROC_TIME MOD 36305 / 6593 
SECONDS t= PROC_TIME MOD 695 / 193 
TENTHS t= PROC_TIME MCD 123 
Jem LATE CODE «/ 
FINI; 


Se324- SECURITY and SECURITYUSE. 
Two special words» "SECURITY" and "SECURITYUSE™ have deen added 
to UPL» and function identically to the keywords "PROTECTION”™ and 


"PROTECTION _ IO". "PROTECTION" and “PROTECTICN_1C™ have odeen 


demimplemented in the Mark 3.3 Software kKelease. 3Soth new 
security attridutes can be specified tn the "FILE" declaration 
statement of a UPL. programs specification overrides the default 


protection valuese 
Valid settings for the "SECURITY™ attribute are: 


- Public 
3 Pr iva te 


WIN RO 
1 


Valid settings for the “SECURITYUSE” attricoute are: 


ID & > 


For both 


- [/¢ 
- [Input 
- Qutput 


attrivutes» zero (2) is the default value. 
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9els dintroduction.- 


The Mark Get? release of CMSIT contains orly minor chanaess 
designed to increase performance and througnput. Datadases are 
ceompletely compatioctle setween the Mark &e2 and 9.5 releasa. 


Databases Deing oOrought directty from the Mark 7.5 level to the 
Mark 9.0 tevel aust be convertad. The OMSTL secticn of the Mark 
Be System Software Notes C€Section 9) 135 j$Incluced in a 
supplemental document titted ODOCUMENT/OMSAELLET fer the users 
cenverting directly fron Mark J7eti to Fe%e Also included 1s the 
DOCUMENT/DOMS» which was tnclucged with the Mark &.3 release» which 
further documents the chanyes to OMSITI in the Mark 8&2 release. 


The Mark 9e3 release of tha CGROL7T4& conpiler centains the 
necessary constructs for datasase accesse The COELL74 comoiler 
uses the same database library files as the cCiAClL cemoitler. For 
complete detaiis»y refer to the CO2CL74 documentation. 


Included with the OMSII Mark 9.0 ralease is a printer dackup file 
Labeled DOCUMENT/DMSUTILS which contains the operating 
Instructions for the UMSTI utility progranse 
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14¢e1. Introductions 


in the Mark 3.% release of the Natwork Definition Larguage (NOL) 
a number of enhancenants have seen tImplenented. The major Not 
enhancements are remote files with simple headerss»s OB2TATCH with 
CLEAK» new MOS control messages tor COS0L74» ara the new Lidrary 
request for COs0L74. 


All references in thts section and the DOCUMENT/SNOL refer to the 
Giste/3l/7uy Systems Network Definition Language (NCL) Reference 
Manuals form number 1273715 aated 17/78. 


Documentation on the Mark 9.3 release of NOL is avaitabdle with 
the program product tn the form of a printer Dackuo fiie tabeted 
DOCUMENT/NoGLe | 


{lo Zole 
The following problems reported in the Mark 8-0 System Notes have 
been corrected (the number In parentheses refers to the numder of 
the problem reported in the Mark 38e0 System Notes)? 


ae The Network Controller wtll display the message "OVERFLOW 
@ FULL MESSAGES DISCARDED™ and continue to execute in an 
overflow condition instead of aborting €12-6€18-277502). 


be The Network Controtter no tonger aborts with “NOD 
PROVISION FOR EGF UN NOL/NIF FILE" €2132°335870M1493). 


. Ce The Network Controller no longer aberts with "NO 
PROVISION FOR EOF Re a 


Ge Intergrity Integrity of tine and station message counters 
is no Longer violated oy switched Line disconnects and 
reconnects when stations are queued on the disconnecting 
tines in a line group €61°2447899249). 


loefeZe 

In the Mark 9.6 release of NOL> aoprogram can cpen a remote file 
with simple headers. With this tyoe of remote filer» the only 
valid message requests which may be issued are STATUS» REMOTE 
FILE INFGs» and SOODRESULTS.~ The program opening @ sirple headers 
file wili not receive any JPEN or CLOSE messagese Refer to 
OGCUMENT/NUL» paragraph 1%4341. 


fay) 


1is2s32 

A new station attribute has been added» STATIOUNCOPENED)D- 
STATIGNCGPENED) is set to true if the station 18 currently 
attached to a remote file. Refer to C3SCUMENT/NOL» paragrach 
100 3eZe 

Afelehe 

A new option for "DETACH™ has seen added for the Mark 3.¢ release 
of NCL. An MCS may now request that tne LSN cf a station being 
detached from a remote file be detached from the Fit of the 
remote file (DETACH WITH cLEAR). Refer to DOCUMENT/NDL» 
paragraph 154232364 


LisZess 

The construct "QUEUE CRF" was changed for the Mark 9.2% release to 
queue the message to the remote file which originally used the 
statton» STATICGNeFIRST»CPENER. Refer to COCUMENT/SNOL>» paragraoch 


1 Fa Pa ey “ee . 

a nee deciaraeion: CUOSBL745ET» and a new requests» COsOL/74SEL» 
have Deen added to the NOL/LISAARY to oerait COBCL74 porograms to 
issue a “"“"SENO"™ with advancing feature Cfor Crit devices onlyd)e 
Refer to DOCUMENT/NOL> paragraph 12543456 


AlaZele 
The advent of COS0L74 has oOdrought with ait the need for new 
control messagese The new control messages are described tn 


DOCUMENT/NOL paragraphs 10.3.5. thru 16.3.12. 
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Aie1. Introduction. 


BlGsG CANOc provides generalized file ocreparation and updating 
céepabdilities in an interactiver terminalroriented environmente 
The CANDE program i353 2 Message Control System (MCS) that runs in 
conjunction with the 31407 NOL system. The NOLmgenerated Network 
Controiler perforas alt the functions related to data 
communications» white  CANDE performs the updating and 
textwediting functions. 


Major CANOc program enhancerents include the ability to snecify a 
muitivwfile id for an output file» a new program switch to 
determine whether or not file security is enabled» 4a secure video 
field for entering the password Gguring Logton at TOf3? terminals» 
and the ability to queue up commanas durinyjy the FIND» %LisST» and 
REPLACE commands. 


Documentatton on the CANDE program is avaitable with the program 
product in the form of 4 printer dackuc file Labeted 
DOCUMENT/TANDE @ 


Alegelse | 7 
The following Aap owe: reported In the Mark 36.5 System Notes have 
Deen corrected (the numbers tn parentheses refer to the number of 
the probiem reported in the Mark 3822 System Notes). 


ae The COMPILE command now uses the file type specified in 
the command correctly €137°333-CM1326). ; 


De CANDE now zips a remove of the files» WORK» RECOVERY» and 
PAGE.FILE correctty even if they do not reside en system 
disk €13-33 @-DN1L1 355 )-. 


ce If the terminal is in scrotl node» the List of an 
external file no tenger has blank Lires inserted in it 
Cisw3338"DMLS51)~ 


Ge When a WRITE command is processed» CANDE crly zips a 
remove of the Dackup file that would bf created to 
prevent a duplicate file condition (€1372387-CM1377). 


ee The password can be changed with the PASSWORD command if 
there ts a workfile present (€15°333"7C0M1396). 


f. ° Transaission of "NEXT ™ no tonger affects PAGE LIT mode 
€13-336°"0413938). : 


disfsfe 
Progran switch 5 was imolemented to determine whether or not 
CANDE will run with file security. If program switch 5 1s not 


zeros fide security 18S enadled-. Refer to DJOCUMENT/S CANCE. 


“file id and a pack id can Be specified for an output file 
f a user logs on to CANCE with a privileged userccde/passworde 
in additions» output file nar2s crefixad with an asterisk C#) will 
no longer 932 expanded so that the multitfile id contains the 
user®s usercode. Refer to COCUMENT/CANCE. 


v4 oe > [po 


Pile 2 chs 
Coanand: can 3e queued up during a FIND» LIST» or #xEPLACE 
commande 


finds: 
A secure video field is disctayead or 73335%3 termtinats during the 
log~or for entering passwordse | 


1122-62 
The tormat of the response te the WHAT command was changed to 
conserve datacomm usage- 


lis2gels 
The (STEAT option cf the FIND and REPLACE commards was changed to 
ailoaw any abbreviation of TEXT. | 


41.2.8. | | 
Two new fttle types have beer added for this retease: FORTRAN?77 
ang CG3GL74. 


4122292 

The CANDE program has been compiled with certain code seaments 
marked as “important™ for optimal use witn the pricrity memory 
managenent systems 


(09-91) % SUTSIDE 
(30202) % CMD_DRIVER 
(C967) % TERMINAL_OUT 
COl+d1) %& SIN_SEAKCH 
CQl»GA) % PAGE_ODRIVE 
(G1258) % PAGE_SHIFT 
(3155£) % PAGE_IN_SETUP 
COl»dF)  % PAGE_IN_SETUP_A 
(Gl»1ic) % PAGE_OUT 
(Glell) % PAGE_CUT_UTILS 
(Gl224)  <% AUDIT_HANDLER 
% SCAN_STUFF 


Cu20G5) 
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Az JEXT/ESLTOR 


1zge1. Introguctigqn. 


The Park 9.2% release of the 31720 TEXT/ECITOR oregram includes 
enhancements and corrections to reported eprediems ir the MARK Gey 
release of the progran. | 


ageisisn | 
The si aa fa command no loncer causes an 
WINVALID SUSSTRING ** OS GA UP* condition when a printer backup 


file ais not provided. The message "MISSING FILE NAME*™ is 
aqisplayed instead. , 


Aielece 
The "PO" conmnand now also disniays the creation aate of the file 
atong with the other information. 


= We we =e «ap ae ee <a wb se CO ae aD a a wee ee ee ee em ae 


AZesels 

The "SET" option has been added to the "SEARCH" comnmard. If the 
"SET™ optton is specified» the cursor 1s positioned to the first 
character of the string in the source recoro which matchea the 
<delinited text>. 


SE ARCH St ee ee eee ee Ce ee nae oe ee ase Ow ae ee ee ee ewe fy 
i iy | 1 1 | 
SEA. Seer iemw LITERAL wrt fe COLUMN we" <column range> -7I 
Ze ti i 
[Pee (ub) ee eers | = Cok. eer] 


Pace KGeUVAIted LOxt>: Seana eee sas se ere Toe ere e ene eee e 
1 ae | i 
Im" SET wel int <secuence range> ==] 
j i 


jn- Stee 


74 


‘wreryss 


"“Imoortant™ segments are now soecified directly in the source 
code. The segments marked as “important” for use with Extended 


Segment Cecay and Priority Memory Managenent gre as follows: 


Ceo ¢) ZERC 
(o2a2) SYNTAK*SCAN 


Cis 6) 
Coe) 
(328) 
ee 3) 


TOKEN DECOCER 
RECCROSUPOATESINITIAL 
RECORCwUPDATC WF INAL 
UPDATE 


ww BR FE FL HX FL 


The following synonyms and abdbreviations to command keywords are 
supported in the TEXT/EDITQR program: 


Keyword >ynony ms/ AD areviation 
COPY WRITE» WH 
CREATE 3 MAKE» M 
BELETE DEL 

HELLO | HE 

INSERT in 

LIST L 

LOAD GET» & 
MERGE | ME 

MDVE | Mo 

PRINT oe 

RE MOVE rE M 

RENAME | TITLE» Ti 
REPLACE REP» FIX F 
RESES@ RES . 

RESTART RECOVER» REC 
RMER GE RM 

SAVE SA 

SEARCH SEA 

SEQ. 3 

STATUS WHAT 

ZiP ? 


In additions any <filestype> scecification can de adbreviated as 
the first character of the <file-type> keyword. For examples 
CCS8CL can be abbreviated as C. | 


Ljs SMCS 


ljs1. Introduction. 
h 


e Bloc Supervisory Message Control System (SMOS) is provided 
for users requiring interactive data communications systems» 
offering the capability of 4@ comprehersive Message Certrot System 
interface to the NOL Network Controltier.e. The SMCS 38s intended to 
ce the supervisor for a data communications scftware systen which 
includes such Surroughs software as CANDEs TEXT/ELLTIR» HASP» 
RJE » as welt as other orwmline packages of either Surroughs or 
Customer origins 


Documentation on the S4CS program 1s availabtie with the program 
oroduct mn the form of a printer backup fite tabdeted 
DOCUMENT/SMCS. 


Liegels 

The following prodiems reported in the Mark 322 System Notes have 
been corrected (the nuabers in parentheses refer to the number of 
the problem reported in the Mark 8-0 System Notes: 


ae SMCS no longer abdorts with "NAME/VALUE STACK <Qverflow™ 
when more than 249 characters are PASSeqd to SMCS 
€13°338°DM1383). 


be SMCS no Longer hangs “waittng message space ir queue for 
wri tee” €13°33870%1452). 


ce If two stations are logged on to SMCS with the same 
usercode/password» doth of those stations can 
Successfully execute a program that opens a remote file 
C13°7333790M1466).~. 


Ge SMCS approves the "PEN" of a renote file fcr a program 
executed from a remcte UBT station 1f the station is not 
logged on to the SMCS program with the "USER" command 
C13-33870Mi407).~ 


ee SMCS wititl find the name of a program in the JO3S file 
correctly» due to new timolementation of the J035_ file 
format» and will attach ail users to the cerract copy of 
the program €13°338°015513. 
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Liege gs 
All references to SPO have been changed to CDT (Gperator Display 
Terminal). A remote SPO station 1s now referred to as a remote 


OCT statione The *"SEND TG SPO" command is now “SEND TO JOT.” 


per yer 
The format for declaring 4a job in the S¥ECS "JdG85" file>» 
SMCS/J0BS» was changed in order to allow 4 user to have the 


program identifier specified in the "SIEN ON*™s "PASS™» cr "START" 
cemmand to Se aifferent than the actual name of the program to be 
spawned oy the SMCS program as a result of the SiGN GN» PASS» or 


START commande in addition» the flaaqs for the various orogran 
attributes have deen simplified. It a JJ2S file exists from a 
previous release of SMCS» the S¥CS program will automatically 
convert it to the new fornat at seginning of fjode This 
conversion 43 not possibdle» however,» if the JCSS file has a 
usercode as the family name Cmultirfileridd). Refer to 
DCCUMENT/S5NCS 6 | 
Loelehe 


The manner in which the SMCS program approves a remote file 
"GPEN™ for a program executed from a ramote UCT station with the 
"2EXECUTE™ MCP control Instruction was changed for the Mark 2. 
release of SMCS so that the LSN which executed the oarogram 1s 
always approved in the OPEN request from the pracrame in 
previcus releases of the S4CS progran» aremote GODT station was 
ferced to log on to SNCS prior to executing the orcgram» or was 
forced to have the program cpen a remote file which was declared 
in the Network Controller and contained exactly one station Cthe 
LSN executing the jobd)>s otherwise the fite CPEN recuest was 
deniede A second remote fite open (1-0) is approved for the 
program if it is for stations not controlled oy the SMCS progran. 


1322232 

Ali stations which are not declared as remote CLT stations are 
now forced to tog on to the SMCS program with the USER command 
before making use of the SMCS program capadilities. Untit the 
user blogs on to SMCS» the onty commands availaple from that 
station are HELP» ID» REPORT» SEND» and TRANSLATE} while the 
user ts Logged on» the ID command is not allowede 


1322262 
A user cannot SIGN ON or PASS to a oragram if that program 1s not 
declared in the "J085" file. 


The SYSTEM" Input command has changed. it 3s row used to 
speci fy the current system identifier and to contrel Lower case 
input message translation for the system. However» the TRANSLATE 
option of the SYSTEM command is used only to set the default. 
value» either ON or OFF and each terminal user has the option to 
change it for the individual termiral by usirg the "TRANSLATES 
input commande kKefer to OCCUMENT/SMUS. 
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4322282 
The header for the PRUGRAM*PASS messag2 now contains Times 
Tatilies and Toggles» and terminal type extracted from the 


criginating nessage header. 


Lisz 


The Shits will now forward any data string follcwing the SIGN ON. 
<program"name> a5 second Inout fo the program identified ay 
program-name if LOG*UN optton is specified in the JCES file for 
that program and the user 15 Logged on to SMCS with tne USER 
command. The SMCS program sends the user's userccde/odassword 
pair as first input and any string fotlowing the orccram name in 
the ccommnand syntax as second inpute 


Aze2elue ° 

Program Switch 2 was inplemented to inhibit the automatic 
execution at beginning of jos of SMCS of any jcb that was tn the 
JESS file with tne AUTG-START option specified. if program 
Switch 2 = 1 the AUTO-START option tn the JO2S file for ali jods 
wiik not be Looked at. 


ig Rei eownaad features the "START™ commande orevides the 
capability to start a job from the host operator display terminal 
CODT). The specified job must be in the JOES file anc is spawned 
by SMCS tn the same way as these automatically spawred by SMCS as 
aresuit of the AUTO*START option specified in the JOBS file. 
Refer to DOCUMENT/SMCS.. | 


LieZel2s : 4 | 

For both the "MAKE" and "CHANGE™ commands» a statior identifier 
is optional for cee changes which affect only the initiating 
statione 


Lje2elies | 

A new command features the "HARDAARE™ command» orevides the 
capability to specify to the SMCS program the chysical orint Line 
size of the system'*s Line printer. The SMCS oprecramn uses this 
informations which is stored in SMCS*S INFU file» when a Listing 
of the -trace file SMCS/TRACE Y5 initiated with the TRACE list 
commande Refer to OGCUMENT/SSMCS. 


When the "J08sS" input commana 1s processed by the S*¥CS program or 
when a MX or WY MCP command is entered as a ZIP string» the SMCS 
will first determine if the program RE is executing ard» if so» 
tf ait will support another PASSed station. If these conditions 
are trues, the request 1s PASSed to kD for a responses oatherwises 
the SMCS requests the function of the MCP. 
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corer 
Autcematic tlogroftf has been iszplemented for all staticns which go 
"not ready. if the station 1S signed on to a pregram and the 


EXCEPTION aption its specified in the JC3S file for that programs 
SMCS sends an exception incicator to the orogran. 


LieZelbe | 

The "SIGN OFF™ command was changed to allow the CLEAR option. If 
CLEAR is specified in the command syntax» the staticn originating 
the "SIGN OFF" is Detached and Cleared from the program's remote 
file Fiabe mefer to the NDL section in this cocument for 
information on DETACH“WITH*CLEAR. Refer to DOCUMENT/ SMCS. 


Liezelfe 
SNCS now specifies the denialtreason in the remote file OPEN 
Reply message: 


No reason Canpproval value). 

invatid CUS0OL74 password. 

Remote file table or program table is full. 
Invalid LSN Liste 


Tan 


DEMO 


13e22i5s | | | | 

The "PASSWORD™ command has Seen implemented for users of COB80L74. 
One system password is set at the host Cperator display terminat 
COOTS. For alt CO3DL74 ENAPLE/SOISAPLE request ressaqes forwarded 
to SMCS. from the Network Controller which involve the password 
options the SMCS program examines the password field which it 
maintains in the SMCS/INFO file. If this master fpassword 15 
blank no check 1s mades otherwise» password validation wiit be 
performed. if the password in the OPEN message frem the Network 
Controller for the CO8QGL74 program is not the sare as SMCS'5 
system passwords SMCS denies the OPEN with denial reason equai to 
2e Refer to DUCUMENT/SMCS. , 


Lye 2019s 


The Program~PASS message format for a remote file with protocol 
type = 2 now contains the station's signat character. Kafer to 
DOCUMENT/SMCS. | 

Ljef220s 


The following changes were made to the SMCS ¢crogram in order to 
ailow a CO8CL74 program to be executed through SMCS: 


ee. if the PASSWORD.USED field is set in the OPEN message Cit 
will be set on an ENASLE bDefore a RECEIVt)» oassword 
vertfication 1s performed. | 


Se 


73 


When the OPEN 1s approved»s SCS issues a CHANGE command 
to the Network Controtler program to change to the 
diagnostic request for each LSN in the CPEN wessagee The 
diagnosic request is declaread in the TERMINAL saction of 
the Network Controtter program as follows: 


DIAGNOSTIC = POLLICTS: RECELVE>s COSCL74SEL: TRANSHIT. 


When the CLOSE message is receiveds if the final close 
bit is set tin the CLOSE nessager the SCS pregran issues 
a change request to the Network Controiler to change each 
LSN Back to the regular request. 


When an ATTACH is precessed»e the SMCS chances the LSN to 
the diagnostic reauest. The LSN 185 chanjgec back to the 


regular request when the DETACH is processec for the LSNe 


SMCS wilt check password on ENASLE/UISAILE recuests and 
deny with reason=2 if it does not mnatche 


SMCS wild handle 73 type messages fcwarced by the Network 
Controiler by changing the type to 73 and sending it to 
the statione 


L4e1- Introduction. 


The Mark 9.6 release of the 61:25 Remote Jod Entry CRYED System 
contains two separate RJE software packages: 


ae An SOL Data Comm handler and INPUT/OUTPUT procran (RE). 
be An SDL Data Comm handter CRJE/DCH). 


4022 Enhancements. 


D4eZels AJES 
The RJ& program has no major changes for the Mark Jee release. 


d4e2e22 RIESOCH. 


The RJE/SDCH program has no major changes for the Mark Pet 
releasee 


When running on Leased tines and the host system terminates the 
sessions the RJE program attempts to rerestablish the Data Coma 
(Ltnke If this feature is not desired» the “"IDLE~ONLUG.OFF™ 
parameter causes the RJE program to place itself in an idle 
state whenever the RJE proegram logs cff the nAost system or 
whenever the host system terminates the data communications 
Linke The RJE program resumes normal operation whenever it. 
receives a nessage from the host system or when the RJE program 
has something to send to the host systems 


Default: The RJE program establishes the data communications 
tink whenever the data communicaticns link 1s Droken 
bf using a Leasea tine. 


NO.RE MOTE 


This parameter requests the 8JE program nat tc oper ae remote 
file for communications with the SUS. This parameter also 
overrides the program switch 9 setting. 


Default: No remote file is opened. 
REMOTE 
This parameter instructs tne RJE program to read fron a remote 


file and process the messages as if they were entered from the 
Qperator Display Terminat CCCT). This option car only pe used 


at 


In conjunction with the S¥CS program oroduct. 


Default: No remote file is openede 


d4o3n2- READ Local Control Conmands 
The "eRkEAC* command has the following syntax: 
| Cee eee e cena $A een nn em oe “---] 
j i 
sRELAD) Seeenaeeseeea see sase ese sees Sess ese Sse em mm tence en| 


fers i se” <deyice type> “3 ores] 
fe-/ 1 f/e- *<filenamer" -~--- aie 
fens 1 7277 <control character> 7] 


The “.READ”™ commana causes the RJE program to oper a cardwinacge 
file and begin transmitting the data to the host systeme when 
endwof"file has been detected the card-image fite is closed. One 
"eREAC® command is required to read each carawrinage file. 


The "eREAD™ command is only valid if the RJE program has been 
properly tloggedton to the host systene It 5s poessibte to 
override this feature oy entering the *%.RY CR™ Local command. 


The <device type>» <filename>» and <control character> sarameters 
are optional and can O5e entered tin any sequence foilowing the 
"eREAD™ commande. 


The <device type> specifies the type of device from which the RJE 
program is to read» and must Oe one of the following: 


CARD 
DISK 
TAPE 


The default device type is "CARD. 


The <ftlename> specifies the tabel of the file. The RJE program 
uses the filename specified to locate the file an the designated 
device typee. The filename must be surrounded by quotes €7) with 
no embedded blanks. The default file name is "RJE/SCAROS"™. 


The <control character>» if specified» must de a question mark 
(?) charactere This option informs the RJE orcgram that the file 


to be opened contains control cards. The RJE program changes 
question gsarks tin column one cf ail cards to a "NULL™ Ca3%4a) code 
before transmitting the record. The host system can then 


recognize the record as a control carce The control character is 
only valid for files on device types of "DISK" cr *TAPE*™. 


Examples: 


<joo"number >AXeREAD 

<jobwnumder>AxXeRE "USERPACK/SOURCE/FILE™ DISK ? 
<jobtnumber>AXsRE DISK ? 

<joOr*numbDer >AX.-READ ? TAPE "SUURCE” 


d4eze3e Remote Supervisory Console Uutout Messages. 


The RJE program displays messages in response to tecal control 
messages~» or when a condition 3s detected of which the operator 
should be notified. The output nessages added in the Mark 7.22 


release are as follows: 
BEGIN TRANSMISSION <device type> File <filename> 


This message is displayed whenever the RJ oregram begins 


transmitting a file to the host systemte The <device type> 15 
either “"*CARKRD"> wOISK *» or “TAPE* and the <filename> 15 the 
Liadel of the file. ; 


CARD READER ACTIVE WILL TRANSMIT FILE <filename> WHEN READER 
BECOMES AVAILABLE 


This message 15 disptayed in response to a *eREAD™ or "eARE” 
Local commande If a file was currently being transmitted to 
the host system when the “"eREAD™ was enterecr» the RJE program 
saves the tocal command and transmits the file when the reader 
becomes available. 


END TRANSMISSLON <fitename> 


This message indicates that the RJE program has detected 
endwof~filte CEGF) on the input file and has closec the filew A 
special endwof"file control message 153 transmittec te the host 
SYS. Ce Me. | 


REQUEST IGNORED? REQUEST eUEUE FULL 


A ™.READ® or “eRE™ Local command was entered while the reader 
was. still active and the request queue is fult (123 entries 
maximum). Rewenter the Local command "-REAC"™ after the current 
file has been transmitted to the host system. 


l4oeze4e RJE Files. 


The following files were added to the RJi program for the Mark 
fej release: | | 


INTERNAL REAO REQUEST QUEUE 
Internal Name: REQUEST.QUEUE 


Label: RJE/REQUEST 
Device? DISK RANDOM 


MCS REMOTE FALE 


Internal Name: 
Label: MCSFILE 
Nevices REMOTE 
Records: 1/73/1 


REMOTE 


C255) wilt 


Number Jf Stations = u 


HEADERS 
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45212 Introduction. 


The Mark Se3 release of the 817395 Host xJE oregram package 
contains several enhancements over the Mark 8. Host AJE program 
packages : 


Bo igp k  a_Hp S S a a. <a aah 


ioe2els 
The RJE/AUTOSACKUP program supports the Mark 9.0 oorirter odackup 
formate 


 RJE AUTOBACKUP program no longer hatts with "INVALID 
STRING "05S OR DP™ when the “SORT_LSUMMARY_FILE”™ gets full. 


iseZ 232 3; 

The xJc/AUTCSACKUP prograt no tonger halts with "INVALID 
SUBSTRING =" OS DR ODP™ when an operand 1s missirg after the 
"EQUAL™ and "RANGE™ options in the "*Ps <file~ic> NEY" conmand. 


1522242 | 
The RJE/AUTOSACKUP program now correctly handles records with 
more than 150 eee characterse 


152225. | | | 

The RJE/AUTOS3ACKUP program no longer sends an extra end of file 
separator “<FS>2" character when sending an ending tadbel record 
for a printer file. 


Leelee 

The RJE/AUTOGBACKUP program now correctly handles the printing of 
Space records when performing Single cr doustle spacing on the 
Line Pea ae ie . 
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1523. Temporary Documentations 


1se32i2 | 
An endwrof"file message 15 transmitted at tne end of a grint or 
punch streame This function can be modifieq By setting the 


RJESAUTOSACKUP program switch i to any cf the fcllowing values: 
G = Transmit EOF message for sath print and punch streamse 


1 = Transnit EQF wnessage for the ourchn stream Sut not the 
print stream. , 


c= Transmit £0F message for the print stream out not the 
punch stream. 


3.= Co not transmit ECF message for either print or punch 
streamse 


ipedece | : 
The RJE/CONTROLLER program cannot be executed without a usercode 
or with a non"privileged usercodee 


Pree err 


The maximus tength of an RSC message transmission is 8% 
characterse If an RSC message 15 tLonger than 30 characters»s 


multiple records are transmitted in tncremerts of 82 characters 
to the Remote Supervisory Console. 


AS-3242 Remote Supervisory Console (RSC) Commard. 
#PH_ CPhone Nunderd 


The *PH command can ve entered in either of the following 
formats > ae 


Format 12 ¥*PH | | 
Format 23 *PH = <phone numper> 


The *PH input command allows the ramote system operator to 
tnterrogate the current phone numdDers or to enter cr change the 
phone number to be used when automatically rerestadtlishing 
connections | 


Format 1 informs the remote system operator of the current ohone 
number. | | 


Format 2 allows the renote syst2m operator to enter or change the 
phone numdere. A phone number is required when the CALLSACK 
option is set and 1s used for automatically rewestablishing 
connection to transmit the remote user*s printer or punch files. 
The remote system operator is notified that the phcne number has 
been changed by displaying the change on the RSC. 


The phone nuacer can be a naxinum of 20 characters tn tLength»s 
including dashes a5 separators. 


Exagples: 


*PH 

#PH 1-222" 333-4444°555 
“PH 333-4444 

#PH 17333-4444 

#PK 1°222-333°4444 


‘ Format: *kO <opticonsname> 


The *kO input command atlows the remcte system operator to reset 
the options used by the RJE/CONTROLLER programe RvE/CONTROLLER 
replies with a verification tnat the option has deen reset after 
each *kD commande 


Refer to the documentation on the *SC input command for a 
description of the allowable options. 


Examples: 


#RO AUTOPRINT 
#0 CALLBACK 
RO AUTOPUNCH 


*SQ_(Set_RJE Option) 


Format: *50 <option=name> 


The *S0 input command allows the remote system orerator to set 
the options. used by the RJE/CONTROLLCAR progran. RJEC/CONTRULLER 
replies with a verification that the option has Deen set after 
each *S0 nessagee : | 7 


There are three allowable run-time remote terminal cetions: 


‘AUTOPRINT When this option is set» all ecrint files are 
automatically transmittec toe the remot2 terminal 
system as soon as the job has been completed» without 
tatervention oy the remote system operator. | 


ALUTOPUNCH When this option is set» ali puncn fites are 
automatically transmitted to the rencte terninal 
system a5 soon as the job has been completed» without 
intervention by the remote system opeéeratcr. 
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CALLSEACK When this option 15 sets» if the rencte systen operator 

dogs off with a job actives connection 15 

automatically rerestatlisned upon comeleticn of thst 

job using the phone nunder supplied ty the *PH KSC 

input command. The printer ana/or punch bSackup files 

are then transmitted to the remote téermiral usere The 

Data Comm line is available for use by cther users 
during the time between log cff and rerestaolishment. 


Examples: 


*5G AUTOPRINT 
#S0 CALLBSBACH 
*S0Q AUTUPUNCH 


x10 _ Clisplay RIE Options) 


The *TQ command can ve entered in either of the following 
formats: 


Format 1: *TQO 
Format 2:2. *®TQ <option> 


The *T0 input command allows the remote system cperator toa 
interrogate the status of the remote oaptions.e 


Exagples: 


#70 AUTOPRINT 
*TO CALLBACK 


#US_CUsercode/Password) 
The *US command can be entered in any of the following formats: 


Format 13 #*US oe | 

Format 23 *US <usercode>{/<password>] PB <aptions> 
Format $3 *US <usercode>{/<password>] PC <cotienms> 
Format 43 *US <usercode>i/<password>] RX <options> 


Format i atlows the remote system operator to obtain a List of 
every remote terminal system in the network By Remete Station 
Number CRSN). | 


Format 2 atlows the remote systen operator tc initiate the 
trans@isston of a print or punch file tc the remote terminal that 
was entered under the specified usercode. 
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Format 3 allows the remote system operator to interrogate the 
host system*s output file directory for files ertered under the 
specified usercode.e 


Format 4&4 altows the remote system operator to remove entries from 
both the directory and the system tnat were ertered under the 
specified usercodee 


Refer to the *Pi» *P)D>» and *RE RSC input commands tn the 
SL38Gu/3171G Remote Job Entry (CkxJE) Reference KMarual Cform 


RlOSC6G2s dated 7778) for the syntax cf tne <options>. 


Exanoles: 
£US 
*#US PAYROLL/ACCT Pu J 125 
*US PAYROLL/ZACCT P® = LASELS 
*#US LEDGER/SFILE PO J 495 


*US PAYR PO = 
*US PAYR &3 5 1901 
*US PAYRULL/ACCT RS 87 


= emote Supervisory Consogte Ck&Sf) Jutout 
BORTEDs» NEED PHONE NUMEER 


Uriginators RJE/CONTRULLEA 
The CALLSACK option was set but no ohone ruber was available 
for the automatic CALLBACK feature. 


#BYE ABORTED» NO DIALOUT LINE AVAILABLE 


Orisinators: RJE/SCONTROLLER 
The DIALOUT hardware ts not presente 


#CALLBACK ABORTED, NO JO8S ACTIVE 


Originator: RJE/ CONTROLLER | 8 | 
This. message indicates that the automatic CALLBACK option was 
set and the remote terminal has loggeao off without any jobs 
executing at the host systen-. 


#70 bE CALLED SACK 


Originator: RJE/CONTROLLER | 
This message indicates that the CALLSACK apticn has been set 


ana a. ahone numoer entered. The rerote terminai is 
automatically called back when the first joo executing has 
completed. When rewrestablishment has occurred with the remote 


terminal» the print or punch Dackup files are trarsmitted to 
the remote terminal. | 
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ae =e <a ke ee nian els. oe am ak ath as ae 


Griginator: RJE/CONTROLLER 
This message indicates that a possibdle hardware natfunction has 
occurred. An automatic program CUMP 15 oprodtced and the 
AJE/SCONTRULLER goes to E0QJ.- 


#ILLEGAL TERMINAL TYPE C 
Originator: RJE/CONTROLLER 
This message indicates that a possidle hardware matfunction has 
occurred. An automatic progran CUMP 1s produt and the 
RJE/CONTROLLER goes to cuJde 


gINVALID LSN FROM STATION STATUS 


Originator: RJE/SCONTROLLESR 
This message indicates that a possidle hardware matfunction has 
eccurrede An automatic program fUMP as produced and the 
RJE/CONTROLLER goes to ECJ. 


A$6el1- Introduction. 


Tre 61599 RJE378 programr allows the remote user to transmit 
queries» programs» and data files to a central computer for 
processing» and upon completion» to receive the firal printer or 
punch output at the sicte remote computere The central computer 
must be using the I3M 3780 data communications characteristic se 
The Mark 9.293 release of tha #619305 RJES738% program includes 
corrections to outstanding problems in the Mark 3.24 812333 RJE378% 
program. 


LéEeg- cohancementss 


1G-e2els 

The aJE378 program now handles the <ESC>M characters correctly. 
When the <ESC>M characters are received Dy the crogrags the print 
line feed is suppressed causing the line printer to overprint the 
text which follows.. 


1Ge2222 3 | . | 
The RJE3789 program now can send Blank records tn Octh compress 
and noncompress mode (13-3387041419). _ 


ltée. 223s | | | 
The RJE37 a9 program new waits to open @onew oackup orinter file 
until awrite to the print file is performed. The program used 


to open 3 new backup print file immediately after clasing the. 
current file regardless a8 wheather there were ary records for the 
file. 


LG0e224e | 

The RJE 37 8O program now sends a HACK® character when a message 
is. received from the host system and the “"sFILE™ file is full. 
The program used to. send a "NAN" character which coulc cause the 
host system to time ™oute The %’WACKT character 15 sant in 
response to enquiries from the host system until there is room to 
receive the next message. When there 3s enough recom to receive 


the mext message the appropriate "ACK" character is sent to the 
host system and data transmission continues (672357127453). 
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16-3. Temporary Documentatians 


160321. HOT READER Eunctior-s 7 
The hOY RtADER function for the RJE327383 orogram 15 tnvoked by 


setting program switch 7 at a3Je If this switch is equat to 1 
CSwW7=1)» the RJE378% program forces the input crimary file device 
type to be a card readere It then opens an tnput primary card 


file» which has the tnternal name of “"“iNPUTFILE". If the file is 
present» the program bids for the line. If accepted» the RJE37 8% 


program starts sending the file. If the hest has certrol of the 
linesy RJE3789 waits until the host gives up control of the tine 
and attempts the Line bide Tf the file 1s not present» the 


program displays an error message con the Operator display 
Terminal CO0T) and on the Line printer and goes to endmafjob 
(EOI). | | 


When using the HOUT REATEx function» the primary file must be 
present and must be a STREAM card deck, otherwise the program 
terminatese. The RJE3729 pregran checks the value cf switch 7 at 
BOJe Since this vatue 15 checked only at Bbeginningtcfrjod C305)» 
the HOT READER function canrot be turned of f once it is turned 
One 


While running with a HOT READER» the stream deck which is the 


input primary files remains apene Any card put in the reader 1s. 
scanned by the RJE3789 orogram for a “"<?>END"» a *<?>DATA 
<filename>*» or a ".Sx" card. An END or a DATA card causes End 
of File CE&OF)I indicator to be sent to the hest fer the current 
file. The next card encountered causes the start of a new file 
to be sent to the host. A ".Sx™ card is processed as a request. 


to start sending the secondary file tc the hoste 


When End of File ("<2?> TERMINATE") ts encountereg oan the input 
primary file» the RJE37S8C program sends an Enc of File indicator 
to the HOST for the current file being transmitted if necessary» 
closes aii open files» and goes to endwofrjcd CEOQJ). 


if = the HOT READER function is invoked» a "Sx" command from the 
GOT is not valid. | 
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The following 17S an example of the input primary file when using 
the HCT READER function: : 


<2>STREAM RUES7TSG/ CARDS 
<?>DATA CARDS 

/*SIGNON REMOTE if 
<?OEND 

<?ODATA CARDSIN 


<card deck to De transmitted to the host> 


<2>END 

<?2>D0ATA CARBS 

050 PAYROLL 

<2>E ND 

<?>DATA CARDS 

030 ACCOUNTING 
<?2>END 
sii ll RJEZSTRG/CARDS 


1feis22 FHandier Notess | 

To deternine the mninimun ouffersize to specify in the data 
communications handler» take the record size of oFILE from 
RJES3780G subtract 59 and add 4» if nonstransparent» or 6 if 
transparent If the record size of SFILE is 562 bytes» the 
mintmua Dutfersize declared in the hardier must de 516 bytes» iif 
operecl es in eee mode 


The 18M 3780 protocol allows for an endine block to be answered 
by a block of data. If this ability of the protocol ts5 to be 
used» the minimum buffersize must be multiplied Dy 2» since the 
transmitted message and the received message are Decth stored fn 
the one I[/0 ouffer.. 


M6232: | | 
If the DISPLAY option 1s aut to a value "n™» $j%“'SO DISPLAY <no>"> 


the first 72 characters of "nn" Lines of every message from the 
hest are displayed on the ODT. "2.80 SISPLAY™ resets the value to 
Ge “n™ must be Less than 16- The initial value is determined by 
program switch 1. Program switch 1 can be set to a value from 9 
to 15 at execution time of the RJE3782 ocrograme 


Lbsda4s 
The following. output message has been added and is displayed by 
the data communications handler: | 


WAITING FOR MCS. QUEUE NOT FULL 
The handler has a message to queue for the RJE378S program 


but the queue is full. The handler NAKs any further messages 
from the host untii the queue full condition is relieved. 
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1623252 | 7 
T following output messages were added to the RJE2783 program: 


NOT ALLOWED IN HOT READER MCLE 


This message is displayed in rescorse to a “*eSx" cammand 
from the Local JOT. When using the HOT REACER furctions 
a *eSx" 15 only vatid in the stream deck. 


STREAM DECK MISSING 


This message appears on doth the BOLT and the Line printer. 
It indicates that the HOT READER function was recuested 

CSW7=1L) but the STREAM deck was not presente. The RJE5784 
program goes to endwof7joo CEOS) and must be remexacuted. 


THE INPUT FILE [35 A HOT READER AND 


This message 15 displayec in response to a *eSTATUS" UDT 
input connand. It indicates that the HOUT READER function 
has been invokede The standard response follows on the 
next Line. 


<?END> CARD MISSING*EOF ASSUMED 


This message is displayed on the GOT whenever a card deck 
is. Deing sent to the HCST and a <?>DATA card is read before 
a <?>EN0 carde The RJES75° program assumes the user wants 
to start sending a new decks and therefore end the deck 
currently being sente | 


If the host system requires a sign-on or logon message to de 
sents there is no facility in the RJE3789 orogran to 
automaticaily send a stgnon aor lLogwon message to the hoste The 


sign=cn or Logon message must be entered by the operatcre 
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Lielse Introductions 


The Mark G9. 5 release of the 212%) HASP program contains several 
enhancements over the Mark 8.3 HASP program. | 


172Z- Enhancenents: 


L7eZeols. 
The HASP program now allows a three character remote 19 field. 
Previously the fietd was restricted to two characters. 3ecause 


of this change» the parameters file created by the Mark 8.9 Cand 
earlier) version of the HASP/MOOIFICR program is net valid for 
the Mark 9ec¢ release af the HASP orogram. The Mark 9.5 version 
of the HASP/HUDIFIER program must be executed in order to create 
avaiid parameters file. 


LieZds es 
The HASP srogram now handles the date and time change at midnight 
and the "TK" MCP commandg correctly. The KASP program used to 


remain in "WAIT" status after the date and time changed at 
midnight and did not process any HASP commands C13" 232" CM1L331)~. 


Lis2e3s 

The HASP/SPO0L program now correctly handles the special forms 
message SSRM<N>.PR<M>» where N = the remote system ID and M = the 
(Ore: nember Cis" 3387081416). 


Lie2ebs mS 

A prodlen with the HASP/SPCOQL progran has been cecrrected where 
the end of file was not correctty recognized for specl files. If 
the "NEW"SPOCL” option was used» permission was not granted to 
send or receive any new or waiting streams. This problem 
prevented the use of the "NEW"SPO00L" option €13°338°"041413). 


1f2225- : oe sy, Foe | | 
The HASP program no bLonger "ACCEPTS" Operator Disclay Terminal 
CODT) input until the "COMMUNICATION ESTABLISHED" message iis 


displayede 

dis2ebe 

The HASP program now terminates correctly when a "eCLOSE™ command. 
1s. enterede The orogram finishes transmisston of allt data 


streams and then logs off the host system even when there are 
iine errorse : . 


die32 Jemporary Cocumentaticns 


Afe3eis HASP MODIFIER. | 

The MEM = <integer> parameter 15 used to specify how @wuch dynamic 
memory the HASP progran is tc use- The integer specified must be 
equal to or greater than the miniaum oynamic memory recuired to 
rune The minimum dynamic memory for FASP in direct mcde can be 
calculated using the following exoresston: 


CZ2*CSUFFERF79) + CLi21LiseCMAXxePRIT+MAX.PUN) ) 
+ CIF PUNCH = 96 THEN 512 * 3) 


When running HASP in SPO0L mode» the minimum dynanic memory for 
HASP can be calculated using the following exeressicn: 


C32*CdUFFER4+7)) + C8*CKAX.PRT + MAX.PUN)) 
if the MEM Darameter 35 not used» HASP/HCOCIFIER catculates the 
dynamic memory for HASP ain direct mode using the fotlowing 


expresstons 


C32" C3QUFFER ¢ 1479) + CL29061L* CMAXLPRT + MAX.PUN) ) 
.* + CLF PUNCH = 96 THEN 512%8) 


If the MEM parameter is not used HASP/MHODIFIER catculates the 
dynamic memory for HASP in spool mede using the fottlowing 
expressions : 7 | 7 


(32*( BUFFER + 143) + CAeCMAXePRT + MAXsPUN)) 
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i8els Introguction. 


The &16uS system utility programs are dasiagned for efficient and 
consitstent operation of the 31°59 comouter systenre Existing 
utility programs are continuaily wedified ara ernanced» thus 
maintatning the quality cf the prograns. As new areas of 
application are defined» new utility orograms are ceveloped to 
accomplish the tasks. | 


This section contains orief cescriptions of new utility osorograms 
that are dSeing released for the first time with the Mark 9.23 
System Software. Also» enhancenents and modifications nade to 
existing utility programs are descrioed here. The utility 
programs named Delow are discussed in this section. 


CHECK/LGAD.DUMP | SYCUPY 
#CREATESTAILE SYSTEMS ACKUP 
DISK/CUPY SYSTEA/COPY 
DaSKETTE/SCOPY SYSTEM/DISK. INIT 
DISKMAP/UTILITY | #SYSTEM/FILE. INTE 
DMPALL | | ®SYSTEMSISMAINT 
LOGCONVERT — SYSTEM/LOAC. CAS 
PACK/INIT _ SYSTEM/LOAD. CUMP 
SORT/COLLATE SYSTEM/SPULUCUOUT 
ee ee ee 


ot = NEW UTELITY 


Volume 2 ae the were eoreases ieee ac Suice ferm #1108966 
contains complete documentation on the system utility ener ranee 
desoribaing the functions and operation of eache 


Paapersey ccc awentscics descrioding the operation and function of 
the three new. utility programs» ii information on the rew backup 
format for Mark 9.3» operating instructions for the enhanced 
SYSTEM/ SPOLOGOUT programs operating Instructions for the 
SYSTEM/LUAD.CAS. programs» and changes to the record format of 
LOGOGCONVERT are tnckuded in a printer backue file named 
DGCUMENT/UTILITY supplied as a supplement to these System Notes. 


482 soe. CHECKZLYAD iP | 
CHECK/LUAC.UUMP 15 a companton utility of SYSTEM/LOAD.DUMP.. 
Accordingly CHECK/LOAD-DUMP will be deleted wher SYSTEM/LOAD.OUMP 
1s oe ede in the next software release. Refer to paragraph 


of 


1822222 CREATE/TABLE- 


CREATE/TABLE 15 a new program which replaces SURT/COLLATE. Refer 
te CDOCUMENT/UTILITY. 


1822232 OLSK/COPY. | 
DISK/COPY 415 deteted with the Mark 9.53 releasee The adilities of 
UISK/COPY are encompassed within SYSTEM/COPY. 


A correction co tie: syntax for creating a pseudo deck is 
required. The stated syntax of "COPY FOXOSK <FILENAME> 956 #1 
PSEULD" does not work. The output file id is required. For 
exagple: "CUPY FOXUSK <FILENAME> 96 1 CUMMY PSEULC". 


Setting SW2 to 1 witt cause UISKETTE/CUPY to nalt on 4 data error 
and request the operator's CX via an accept message before 
continuinge Without SW2 set DISKETTE/COPY deletes the sector in 
errors displays an error message and continuese 


1o22222 QLSSMAP/UTILITY» 

The following probdlemn has been corrected? When a disk pack was 
"SN"ed to become an additional system pack ano the cther system 
disk was a 5N feadwpercwtrack disk» vISKMAP/UTILITY would fait» 


somthing) 64 missing sectors an the disk packe 


iogrebies relating xs headmper =track disk has been fixed where 
the "CHECK" option produced a Listing showing no errors. The 
WCHECK” option will new give a tistiny shewing “phase one errors®™ 
Eve: the. aur. ae "ALPHA™ options currently de. 


Las2ebe ODMPALLS 
ENC may now be used with ASCII on an output file. 


A. sreoles with DMP ALL that Cpoaneer an exact cuplicate file when 
‘ieee to EBCDIC Ere te ye cor was specified has been fixede 


182227  LOSCONVERT= | 

LOGCONVERT now retains the parent job numder when a jod is 
spawned. This. record is added to the SCKECULE Record Format 
file. The record type field has been changed from a numeric 
field to an alpha field. Documentation for the LOGCONVERT 
procarm is available in ae printer dbackuo file Labelled 
DOCUMENT/UTILITY. 


LaaZefs PACK/INITs 
it ws now possidte to initial a single cylincer of a pack» 
without disturbing other data on the pack» oprovidirg the entire 
cylinder is available. Tnis feature is incorporated into the 
cylinder initialize (CI) option and is enaoled when the CYLINDER 
INITIALIZE option has been specified and the O5T is the input 
source Coption is not allowed with card input). When the 
CYLINDER INITIALIZE ostion is specified the PACK/INIT program 
asks the question» "00 YOU WANT TO PURGE?". If a NO answer is 
given»  onty cylinder addresses which are in the available table. 
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are accepted to initialize. 


‘eu. conan aes ee 


SORT/ COLLATE 1S. Paeistod with the Mark 9.3 release. The program 
CREATE/TASLE replaces the SORT/COLLATE ability to create. 
translate taoles. The SOxT program has the ability to generate 
coilate tabdlese 


1822219- SQUASH/USER.DISK. 

SGUASH/USER.GISK now displays appropriate messages at the time of 
the beginning and ending of the job and if the job can not be 
started due to some programs stilt running on the designated 
drtvee The following messages were inplenanted: 


1. At the time of baginning of joo: "DO NOT CISTURE 
<unit“mnemonic> UNTIL FURTHER NOTICE. 

Ze At the end of jods "<unit-mnemonic> LABELLED <nackwid> 
IS NOW AVAILASLE FOR USE. 

3e If pack to de used is cusy: "ACTIVITY MUST CEASE ON 
<unit*anemonic> FOR JISK SQUASH TO CONTINUE” 


Bes. ‘ci aa aay as aan ome 


The SycaPy program ¥s Setng deleted with the Mark 9e3 reteasee 
The SYSTEM/COPY program 15 now used for iiocrary tapes ana the 
need to eoDy SYSTEM/LOAD DUMP tapes no longer exist se 


19222122 SY STEM/BACKUP» 


The ability to print BANNERS Ca title paged has Been added 
| BANNERS are eet. ute 7 | : | 


1... Suiteh a is set to any vatue from 1 to 15 inclusive. 
Ze The file is labeled. 
30 The “forms” oper oD for’ the file is not sete 


BANNERS includes: 


“The "igen cae. Cif present) Hacer which the progran 
Tae executede _ 
2e The external file name tn the creating programe 
3. The actual file name on the disk or tape if different 
from 26 


Pack-IDs are omitted In cases 2 and 3- Lach of the oossiodle 
three items. is. separated by a line containing the creating 
program's name repeated across the page. Usercode multitfilerI0Ds 
are omitted from <@ and 3 if the usercode has atlready been 
Pile ees __ : | 


"On PRT/= LABELS" now gives the vatue of the AUTOPRINT CATP) bit 
along with the header and record counte 


The backup file format has changed with this release. Any user 
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progran which relies on the oprevious format will need to be 
modified. Refer to DOCUMENT/UTILITY for details. 


The Nark 9. pelca.c. of SYSTEM/COPY includes the new separate 
COMPAR feature and the new VOLUMEINCEX attribute. These are 
sccernead Delowe | 


The COMPARE function of SYSTEM/CUPY is row usable independently 
of the COPY function. COMPARE is used to compare previously 
created disk and/or Library tane files. The syrtax for the 
COMPARE command is similiar to the COPY commarcd syntax except for 
the restriction that cnly one input and one outfut unit can  5Be 
specifiede SYSTEM/COPY produces a listing of the files compareds 
flagging any errorse The syntax 1s Listed pelew: 


yi | ] 
tAS <filerida>t 


Examples 
COMPARE = FROM MYTAPE TO MYDISK CKIND=CISK)> 


Ir the example aboves. att the files on the tape ¥4YTAPE are 
compared against the Pikes with the same name en the disk MYDISK.e 


- COMPARE FILEL AS FILE2> KYZ/= FROM TAPEL TO TAPE23 


In the eneepe aboves FILEL on TAPEL is compared against FILE2 an 
TAPEZ» and ali files with a family name of XYZ on TAPE 1 are 
compared with those files with the same name on TAPE2. 


It is) now possibile via the VOLUMEINDEX attridute to srecify which 
reel of a multivolume input tape should be used. dy default» 
SYSTEM/COPY starts with Reel #1» and scan all reels until it 
finds the desired files. The VGLUMEINCEX attribute 1s used to 
direct SYSTEM/COPY to start the search with a reel other then 
Reel #1. a | 


E- Xap. las 

COPY =/= FROM MYTAPE CVGLUMELNDEX=2) 
The above example directs SYSTEM/COPY to ignore Reel #1 of the 
tape MYTAPE>s and copy onty the files on Reel #2 and all 
subsequent reels. | | 
DIR TAPE "MYTAPE™ CVOLUMEINDEX=2)3 
The above example shows that VOLUMEINDEX may also be used in a 


DIR commande In this exampte SYSTEM/COPY prints the atrectory 
contained on Reel #2 of MYTAPE. Fach reet's directory Lists the 
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files contained on that reel and all the following reels. 


VBe2elSe SYSTEMZOISKR-INITS. | 

It as now possible to initialize a singte cylinder cf a pack» 
without disturbing. other data on the packs providing the entire 
cylinder ts availaodtle. This feature 15 tncorporated into the 
cylinder initialize (Ci) option and is ensoted when the CYLINDER 
INITIALIZE option has deen specified and the DOT is the input 
source Coption is not atlowed with card incut ). When the 
CYLINDER INITIALIZE option is specified the SYSTEM/SDISK.INIT 
program asks the auestion via the ACCEPT message "00 YIU WANT TQ 
PURGE?". If a NO answer 38 givens orly cylinder addresses which 
are in the availanple tabte are accepted to initialize. 


1822215- QYSTEM/EILE-INAGT. 


SYSTEM/FILE.INIT is a new opregram used with COsBCL74. Refer to 
DOCUMENT/UTILITY for details. 


23222192 SYSTEMZIS.MAINT. 


SYSTEM/ISsMAINT 15 a new program ae with COBOL 74. Refer to 
DECUMENT/UTILITY for details. 


A822 wits SY STEM/LDAD= CAS. 
Tracie ne CAS 315 no Longer aeecuced via the "LUE" input messagee 


The SECS now enters a comment into the System Loge 
SYSTEM/LOAD-~CAS must de explicitly executed. Refer to 
DCCUMENT/UTILITY. | 


Lge2e182 SYSTEM/LOAD-OUMP. | | ns 
Beginning with the Mar 6.) pelease SYSTEM/COPY became the 
vehicle for generating Library taoese. SYSTEM/LOAD.CUYP was fully 
taplemented in Mark 8-6 to provide the necessary time for change 
over of library tapes. In the Mark 9.8 release SYSTEM/LOAD.~BUMP 
ts modified to be tnput only oy deleting the "CUMP”™ and "AD". 
input messagese. in the next software release SYSTEM/LODAD.~jDUMP 
wilt be deleted. . 


1Be2019- SYSTEM/SPOLOGOUT» 


SYSTEM/SPOLOGCUT has oeen changed to allow selective printing of 
the OCT output. ‘Refer to BOCUMENT/UTILITY. 
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oduction.s The sgurroughs Time Analysis and 31ltling 
dete cra8h5 pugs one enhancenent tor the wark S24 release. The 
ok Ge files must oe updated prior to running on Mark 9e36 


~ 


The “print fields tn TASS/SUM have bean increasad to 4 digits. 
This allows for a figure greater tnan 399 hours (21°156°705510)- 


See3en12 MREPCRTI™ and aESCER" options. 


The "REPORT" and “"JRCER™ options are used as ineut to the 
TABS/ UPDATE programe , 


REPORT ini opticn allows the user to recuest reports Dy names 
The "REPORT" option may be used tn conjurction with 
Sattch settings Cwhich also request reports)+s howevers 

the TABS/EXEC reports cannot Se specified with the 

switch S setting if the "REPORT" option requests either 


ef the reportse The "QRDER™ option must oe used to 
specify the ordering to bde used in the TASS/EXEC 
reports. — The "WREPORT™ and WORBER®™ attribute 


restrictions apply only to TABS/UPDATE input. 


The FPREPORT™ option must appear on aoe ophysicatty 
separate record from any other optione Severat reports 
may Se requested on a single "REPORT" cption records 
the names of the reports must be separated Cy commas cor 


by: oLanks e. 
ORDER The aHAnER™ Sak ton 46 used only in cerjunction with the 


"REPORT™ options and only when the “REPORT™ option has 
requested that one or both of the TAES/EXEC reports be 


printed. The "ORDER" option is usec to specify the 
ordering to de followed in these repertse Valid order. 


types are "TIME™» "CHARGE™s and "NAME™. These specify 
that the ordering 1s to be basec on elapsed tine» 
charge numder» or programa name» respectivelye 


2823222 O45 ceportina in TAsszeExece reports. 

The “Itemized Execution feport™” generated by the TASS/EXEC 
program now includes information on datadase ard OMS processinge 
The reported information consists of: 


le logical data base name 

2e physical data base name 

Ze time of open 

&- open type 

Se unit name 

Be device tyoe 

fe tine of close 

Be pack name 

Je processor time devoted to this data base 

Cincuded tn joo's processor timed 

ldQe nmumber of updste operations 
lle nunder of non update operations 
l12e data base open time 


are is a report generation program in the TA&S package. 
This. program produces the “Data fase Managemnert Statistics 


Report". | TASS/OMS as executed only when this report 1s 
requested. Program switch 7 requests this reperte Valid 


settings for switch f are zero C3)» one Ci)» and three (3). 


The "Data Base Management Statistics feport™ prevides statistics 
on ali data base activity during a days A section is printed for 
each OMS structure invocations each section provides the 
fotkowing information. | : 


1. structure name | 
Ze time of tnvocation 
3e physiticat data dase name 
4e job nunder 
Se frble name 
6- hardware unit and device Hype 
7» numder of finds: 
a. numaber of Inserts 
Fe number of updates 
10< number of deletes 
11. number of system changes 
i2e nunbder of exceptions 
12. mnumder of reads 
14. numder of writes 


The DMS statistics compiled By the TASS/DOMS program are not 
reflected in the TA&S billing reports. OMS information which ts. 
assigned to charge numbers and reflected in the SOilling reports. 
is discussed itn the TASS/EXEC "Itemized Execution Report™. 
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2823242 Recovery and Restart Capability. 


When any orogram in the TA2S package terminates abdnorrally» TA3S 
must not be ratexecuted until the integrity of the permanent TA3 
Gata files is ensured. Reprocessing evan a single day*s tag 
infcrmation can result in inaccurate overbdililirg te system users 
because TASS maintains cumutative monthly statistics tn its 
permanent data files. If the abnormat ECJ cceurs during 
execution of TASS/UPDATE» retexecute the programs Cata 15 not 
corruptede If the abnormal £CJS occurs during TASS/L°OSQUT» then 
the recovery or restart cause a lity of the TASS packacea must he 
usede Refer to the subsection “Discussion of Sigole Recovery” 
fer information concerning atorts of other programs in the TABS 
package. 


If the system has Seen coldstarted since the tast execution of 
the TA3S packages» the restartrtrecovery capability must Se used to 
recover any oprewcoldstart information either from data files or 
from unorocessed tog files. Ahen a system fails and a coldstart 
of the system disk pack 15 necessary» atl MCP cpticnss including 
the "LOG™ option» are resete Logs created after the colidstart 
are sequenced bdeginning with the number one. Any logs created 
before the coldstart Sut unprocessed by the TA3S package are not 
processed untess a coldstart restartwrecovery 1s requested. 
These precrcotidstart logs must have been DdDacked up to 528 made 
available to the TASS package. Also» the TAS cermanent data 
files must ode availablee if the coldstart occurred while 
TABS/LOGOUT was executing» the recovery option 15 itinvoked> 
otherwise» the package is restarted. Setting program switch 8 to 
2 requests a coldstart restart or recovery. Duplicate reports 
may de produced: duplication Cin this case) does rot corrupt 
dat ao. | 


The recovery option of the TA85 package resumes processing at the 
day and time that was being processed when the adnormal EJ 
occurreds the restart option resrurs the entire jcbh» possibly 
reprocessing many days' information. The value of oroegramn switch 
8 determines whether a simple recovery or a coldstart restart cr. 
recovery 1S performed. A simple Cswitch 8 = Us no coldstart) 
restart must be done manually» and requires that doth the tog 
files and uncorrupted copies of the TAss data files be available. 
A simple recovery Cswitch 38 = 13 ono coldstart? alse requires log 
files. and uncorrupted copies of the TASS data files to be 

avaitlaotey» and resumes processing at the day and tine that was 
being processed when the abnormal EQJ occurred. When a coldstart. 
restart or recovery is requested (switch 8 = 2)% the TAES package 
determines if a recovery or restart is needed» based on whether. 
the tast TAS8S/LOGOQUT execution terminated normalty Crestart) or. 
sprout ey Crecover). 
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2 ee a SE} wate 7 wep ce ce: eer wo 


6 Defaults normal rune without restarttrecovery 


or simple restart (manual) 
1 kecover after abnormal EQ’: no coldstart 


2 Cotdstart occurred? restart -recovere 


No restart@recovery is recuired after a clear start unless. the 
FAIS package was executing at the time of the clear start» and 
Was aborted. | 


A restart rewexecutes the entire unsuccessful runs» recroducing 
all requested reportse A restart is only valid when TA3S/LOGOUT 
terminates acnormally. | 


A simple restart after an abnormat E0J can be accomptished onty 
in the following casese 


Ae Af the unsuccessful execution of TABS/LOGOUT ts the first 
execution of the TA8S package during a month» and the days 
being processed are the first days of the wronths rerexecute 
TASBS/UPOATE with the create option (SW 8 = 1) set» and the 
permanent data files are rarinitialized. Ther rerexecute 
TABS/LUGOUT. 


Steps. 


le Remove all TAR files. C7RE TABs=" of PRE 


Ze Execute TASS/UPDATE with the create option set. 
CTEX TABS/UPDATE SW 8 = 17). © 


3e If executing from a user pack» move the TAS files to 
the user pack. 


we Execute TASS/LOGGUT CTEX TASS/LUGOUT"). Program 
| Switch 8 must be set to zero Cu). 


Be If the TABS package has been executed with the "SAVE" option 
ons» then a copy of the TAS permarert data files 1s on the 
tape “"TABSFILES™s» which was made at the end of the last 
successful execution of TAIS/LCCOUT. After replacing the 
potentially corrupt TAS files with the backuo copies on the 
tape “"TABSFILES"s» rewexecute TABS/LOGOUT. 


le Remove the TA8 files CRE - TA3/=" or wRE 
MYPACK/TAE/="). 


2e Use SYSTEM/COPY te copy the backup files to disk 
C*coey =/2= FROM TABSFILES™ or 
"COPY =/= FROM TAGSFILES TO MYPATK CKIND=0ISKI" 9. 


30 cxrecute TABS/LEGCUT C"EK TASS/SLOCOUT"). Program 
Switch 8 must be set to zero (ude 


Simple Recovery (Switch 8 = il 2 


The recovery option causes TASS/LOGQUT to process aontly those days 
not processed during the previous execution cf the TASS/LOUGOUT 
Cthe execution which ended with an adnorrat EDJ). Recovery 
processing begins with the day and time in process at the time of 
the abnormal coJ- Some operator intervention may be recuirede 


eee 


le Execute TASS/LOGOUT> requesting a simple recoverye 
C"EX TAB S/LOGOUTs SW 8B = 1"). 


Ze =Ss (Not always eseuinece) Determine the programs te pe executed 


during the recovery pass by answering the questions displayed 
by: UREOOL ERAS on the GET... 


Questions are in tie 4etbeatnd formate. 


-% TASS/LOGOUT 
% TABS/LOGOUT 


<job #> DO YOU WANT TO EXECUTE TA3S/<program>? 
eee #> ENTER YES GR NG. 


Phere Mseraeae must respond "YES" or "NO™ in an accept message 
to the programe aA "YES" response 1s entered when the reports 
generated Dy the program in question have not deer produceds 
a "NO" response is entered if the reports have already been 
produce de In these sttuations» tnadvertent auplication of 
reports 15 harmless» and does not corrupt data files. 


iscussion of Simote Recgvery 


TABS/LOGUUT and TABS/REPURTGEN both process a targe amount of 
data in permanent and temporary data files» therefcres if either 
fails to complete its processing tasks successfully» the day 
being processed at the time of the abnormal E04 aust te 
completely reprocessed. If the two abdove"named programs 
successfully complete their processing tasks» 3 recovery run 
continues processing the reoort*generating programtse. 


~ 
co 
~ 


There are seven permanent TAG data files» Sut only two 
TAB/CUSTOMERS and TAB/PERTPH@= caontair monthttotdate statistics. 
Unty four o f the nine daily oproarars7> TARIS/LOGOUT» 
TAdS/REPORTGEN» TABS/MIX» and TASS/FOWR-- alter the files anda 
totais to the extent that duplicate execution produces erroneous 


information. TASS/LOGCUT remains tin the mtx for the entire 
execution sequence of the TAGS packager Sut it finishes its daily 
data alterations before calling the other oprogramns. The 


execution seguence is as follows. 


Le TASS/LOEGOUT Cdata altering) 
2e TABS/SREPORTGEN Cdata altering) | 
3e TABS/SACCTS 


Ge TABSSAIX Cdata altering) 
Se TABS/SUM | 
60 TABS/HOWR | (data altering) 


8s TABS/ERR 
9. TABS/&EMS 


Only those programs. whose reports are requested are executeds 
the execution sequence remains the sdameps with non requested 
procrams skipped. | 


When TASS/LOGOUT is executed with program switch 2 = 1» it checks 
the two permanent data files that contain month=to~date 
Statistics CTAB/CUSTOMERS and TAs/PERIPH) to detersine which of 
the data altering programs have been executed for the day odeing 


— processed when the abnormat E0J occurred. In no case should 


these programs be rewexecuted during recovery. TAES/LOGIUT onty. 
receives. explicit information adout the status of the 
datacraitering programs? however» it can extrapolate information 
adout the nonw-datawaltering programs Oy noting the position in 
the execution sequence of the datavwaltering oprccrams that have 
beer executed and comparing the postition in the séaquerce of the 


non data~altering programnse For iainstances af TA3IS/MIX has 
completed» then TA&@S/SUM has alsa compteted? howevers if 


TABS/MIX has not completed» then TA3S/LOGOUT displays a message 
asking if TASS/SUM should be executed. | | 


Recovery of a coldstart recoverycrestart rur which terminates 


abnormatly is passible> if» in the coidstart recovery» 
TaAsBS/LOUGOUT has completed its leg processing tasks. If 


TASS/REPORTGEN has gone to “3eginning of Task* {(s0T)» then 
TASGS/LOGOUT has completed its tog processing tasks-e To recover 
from this situations follow the steps outlined fer a sinple 
recovery run of TADSS/LOGCUT. | 


Executing the IA8S Package After A Coldstart 


A cotdstart restart recovery run is required wherever a system 
has been coidstarted since the Last executicn of the TASS package 
if any prewcoldstart information 1s to be processede if the tast 
execution of the TASS package terminated normally» the restart 
option 1s invoked», if the Last execution terminated abdnormally» 
the recovery option 35 iInvoked.« The TAES restarttrecovery 
mechanism determines which option 15 to ode trvokede Some 
operator intervention may be required to determine «which programs 
are to be processed during th2 recovery passe Refer to the 
preceding sections “Simple Recovery» Step 2%» and "Oiscussion of 
Simple Recovery™ for additional inforaation. 


A coldstart restart7"recovery run can process only the information 
that is not destroyed during tne cotdstart. Maximum recovery of 
data occurs if ali log files are Dacked upge and either the "SAVE" 
eption ts used on all TAsS runs» or the TASS packace (Cincluding 
ali data filkesd 185 maintained on a user packe If the TAd 
permanent data files have oeen destroyed» TASS/UPCATE must be 
executed with the "CREATE™ option set to reminitialize these 
f 4. €S.e. | 


Coldstart Recovery 


To restart the TA3S package and to recover alt TA8S information 
after a coldstart» prevcoldstart logs and the TA3 permanent data 
faites must be available. If the coldstart occurred while the 
TABS package was executing» causing it to terminate adnormall yo 
and the TAGS package 1s matntained on a user disk» the recovery 
mechanism resumes processing at the point at which the adnormal 
EgJ occurred. 


Im both cases described above (logs and TA3 files are Sacked up» 
or TASS 15 maintained on 2 user disk)» all acnthly information 
remains intact. if the permanent data files availasle were not 
produced by the most recent run of the TA&S package» however» 
duplicate reports may De produced. 7 


| Steps 


1e Load all unprocessed premcoldstart logs ontec the system disk 
Cor the user pack from which the TA3S package is executed). © 
TABS knows the number of the log with which it ais to begin. 
processinge 


2e Load the sguee TAB permanent data files ontc the system diske 
ead the TASS ae is maintained on a user disk» skio this 


3 Execute TABS/LOSOUT » | specifying. the coldstart 
restartvwrecovery option. | | 


EX TASS/LOCGCOUTs SW 3 = 23 


4e Werify that the logs that TABS/LOGOUT expects to process 
include all prescoldstart Logs. TAES/LOGOUT cisplays the 
following nessages during verificatione 


ATABS/LOGUUT = <jods> CUNSECUTIVE LOSS NUMEERCD <#a> THRU 
<#p> ON DISK. PLEASE VERIFY THAT THESE ARE THE UNLY LOGS) 
TO 3c PROCESSED DURING COLOSTART RECOVERY. 
ATASS/LOGTUT = <joba> ENTER YES Tod WERTFY OR <#> TO DVERRICE 
TF <#p> 15 NOT TO Bt THE LAST LCG PRKOCESS£D CURING RECOVERY. 


The operator should verify with an accept CAXK) 2855392-6 A 
"YES™ response causes TASS/LOSCUT to becin crocessing the 
logs namede An override response (€ <jod#>AX <#c> J) changes 
the Last log to be oprocessed durinsc recevery to the 
prewcoldstart log numbered tc. If #c is tess than #8» the 


information tn logs with numbers greater than 4c is loste In 
no case should #c be the numder of 3 £pest*colidstart togs 
since only prevrcoldstart logs are processed during the 
coldstart recovery passe 


Se Remove the tog files precessed durine coldstart recovery 
after TASS displays a message specifying which tcgs have been 
processed. Even if the "REMOVE" option is set» TASS never 
removes prewcoldstart iogfiles. 


XTABS/LOGOUT = <jobs#> PROCESSING GF LOGS CREATEC 3EFORE 
— COLDSTART COMPLETE. TABS WILL NOT REMOVE THEM FROM DISK. 


After displaying the above messages TASS/LOGQUUT begins 
processing post=coldstart Logs and dayse 


foldstart Restart 


When Site the Log Files. or the TAR permanent data files are 
unavailable after a coldstarts information that was contained in 
Enos? files is Loste ? | 


Ae. Permanent Data Files Available» Log Files Not Avaitaole 


if the TAB permanent data files are available» but the togs 
were destroyed during coldstarts then the rorthly totals 
accumulated tn the permanent data files are valid» although 
the unprocessed information contained in the tost tog files 
is mot reflected. Processing degins with costrcoldstart 
Logse : 
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Steps 


le Execute TASS/B8ILLING if prescoldstart bitlirg reports and 
gtatistics are desired. The TAs permanent data files 
must be avaiiabie. 


Ze Rerinitialize the TAZ permanent data files» 4y executing 
TASS/UPBATE with the CREATE option sete The TAS files 
must de rewinitialized in order ta set the tog file 
pointers that TA&S naintains. 


EX TAGS/UPDATS> SW 8 = 1s; 
3<¢ Execute TASS/LOGUUT» without setting program switch 8. 
The restartrreacovery capability cf the TAtS package is 
not tnvokede TASS/LOSOUT oegins oprecessing the logs 
created after the coldstart. | 7 


Pre-coldstart Logs Availaole» TAS Files Not Availaole 


If the prewcoldstart tegs are available» out the TAS. 
permanent data files are not» the information stored in the 


data files ts Lost. Cnily the unprocassed information stored 
tn the log files can be recovered. Steps 4 ard 3 bdelow 


request user input to specify where the restart is to begine 
Beth responses are necessary for TA®S to find its starting 
Locations Because the TASS pointers were stcred in the Lost 


Steps 


le. Rerinitialize the TA&® permanent data files say running 


TAB S/UPDATE with the "CREATE™ (SW 8 = 1) option set. 


EX TABS/UPDATE>s SW 8 = 13 
2e Load the precotdstart lcgs to o€ precessedc during the 
.¢@eeldstart recovery pass to the system diske Include togs 
that were processed before the coldstart if recovery of 
the information contained in these togs is desired. 
Reprocessing the tags does not ccrrust the data files» 
Since the data files are Deing recreatede 


3. Restart the TASS package ody executing TABS/LOGUUT with 
the coldstart restartvrecovery option sete 7 


EX TASS/LOGOUTS SW 8 = 23 


4e Specify the prewcoldstart legs to be processed by 
specifying the smallest and largest teg numbers to be 


processed during cotdstart restart. Missing 
Cunavailable) Logs» after the first» do nct affect the 
restart» but cdo require operator intervertion during. 


later processing to skip the logs. 


TABS/LUGOUUT prompts tor the log numroer rarge with the 
following messages. | 


ZTASS/LUGOUT = <jpob#> COLEUSTART RESTART RECUESTED. 
PLEASE SPECIFY LOG NUMBERS CREATES BEFORE CCLOSTART 
TO SE PROCESSED sY TAGS. 

ZTABS/LOGOUT = <jod#> ENTER <4> THRU <#> GOR ELANKS 
IF CULDSTART RESTART IS NOT GESTREDs— 


The operator must respord with an accect wnessage. 
txamples follow. 


<job#> AX 5 THRU Ly 


é 


<joba> AX 2olank inputs restart terminates 


Srectfy the first date to be processed during the 
restart. Again» TASS promots for this input. 
information pertaining to days ofpricr te the date 
specified 15 lLoste 


ZTABSS/LOGOUT 


<jobs> PLEASE SPECIFY STARTING SATE TD 
ine. 3 PROCESS. 
ATABSS/LOGOUT = <jobs#> ENTER <MM/DD/YY> OR BLANKS IF ALL 
PAYS IN LOG ARE TG B= PROCESSED. 
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Zis = 3YCUM 


Z2isis Introduction. 


The Systems Communications Module. CSYCUM) pregram provides the 
Bigec user with: | 


le The ability to sudmit jobs to run an ancther system. 
Ze The ability to transfer files oetween two systemse 


30 The aoility to ianteractively ovtain services and 
information from another system with the abditlity to 
communicate with interactive programs in a regfote system. 


Jobrrun cutout can be returned to the suyvmitting systen Cupon. 
request) or directed to a aeripheral device on the processing 
system itself. Interactive outout data is returned to the User 
Systee directly» via Network Controllerse 


The SYCOM program along with its associated network centroller is 
responsiote for all data communications with other systems~s This 
tnciudes performing the necessary functions to establish tine 
connections» receive/transmit data» and execute the correct Line 
termiratiton procedures. 


The SYCOM program maintains a secondary level af control (MCP has 
primary control) over local peripherait devices such as the card 
reader» card punches Line printers and magnetic tacese. It neads 
and transfers card» tape» and disk files» accepts input from and 
displays messages to the ‘Operator Cisplay Terminal CooT) and 
receives data files/messayges for orinting» cunchings display» or 
writting to either tape or diske It provides the mechanism by 
which a terminal or application program in cne system is able to 
communicate with specific acplication programs in arother systeme 
Program selection ¥s Dased on the servicing system which dictates 
the processing requirements Cprograms) optioned to run in that 
Sy ST. eM. stag Aye ite ae | a 


The SYCOM system is a program product which may be separately. 


ordered. Decumentation on the SYCOM program is available with 
the program product in the form of a printer backup file Labeled 
DOCUMENT/SYC OMe The 21200 SYCOM program can be ordered through 


the Local Burroughs office. 


The Mark 925 release of the SYCOM procran includes enhancements 
and corrections to reported scrobdlems. New features tnclude the 
enhancements to the "REAG™» “ASORT%» "COPY™% >» “"FETCH™» *PUT™» and 
"RESTART" commands. The new "SUFFER™» "a5" and "SIGNAL™ commands 
and the new "THACEAREAS™» "TRACE DA» “TRACER S">» ara "QUEULESTZE*™ 
parameters have been inplementede Atsos the fernmat cf the SYCOH 
procram’s parameter fite has been changed to make creation and 
updating of tt much easier. These enhancements are cccumented in 
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the SYSTEMS COMMUNICATION MOQUULE Cs YCOM) Cocumentatione 
Corrections to outstandirg provlems are accumented in the 
following paragraphs. 


Zisie Enhancements. 
a Pere ee | 
lf a terminal 15 not connected» input messages te the syYcO0m 


program no tonger have to de prafixed with the pericd "-e" default 
pseudo"signal charactere 


Lielege 

The "LOG" command generates the foltowitng informaticn in addition 
to the hardware errors and software counters oreviously 
dusplayed: | , 


le The average numder of characters per transmissions 
Ze The number of files that have deen sent and received. 


The "LOG CLEAR”™ command initializes to zero all ccurnters which 
are displayed tn response to a “"LOG™ commance 


The SYCOGM program now handtes alt file separaters correctily- 
Alsc» the following messages are now displayed on the dJoerator 
Display Terminal C0DT) when a print file is received from a host 


PRINTER OPEN CWhen the host sends the beginnirngtof-file separator) 
PRINTER CLOSED CWhen the host sends the enarcf-file separator) 


gleZshs — | ) | 
The SYCOM program no fonger. sends a trailing record separator 
<f'3> character in the transmission Duffer» thereby reducing Line 
activity for file transfers and card image transmissions. In 
prior releases of the SYCOM program» the record separator <nKS> 
and. end of text <ETX> characters were sent at the erd of a card 
transmission buffer. 


2122 2: 

Att coutput messages which reference an internal file name in the 
SYCOM program have been _ Shenees to reflect their external file 
nNnagese | 


gle? 2&e= | 

The SYCOM program now displays "PUT AsORTEC™ or "FETCH ABORTECDO™ 
when a "PUT" or a "FETCH™ command was aborted» respectively. in 

prior releases of the SYCO4 programs oniy the message "PUT 
ABORTED" was displayed. 


LleZele 

The SYCOM program no tonger hatts with "FATAL ERROR 1149256382" 
when a "CONNECT™ a5 tinitiatec and the program is "SIGNCD OFF" the 
SMCS program before the connect 15 complete. 


1. . 
ee ane number of consecutive tineouts received Dy the SYCuUM 
procram exceeds the value contained tin the "TIMEQUTS" parameters 
the SYCOM program displays “CFFLINE™ in resconse te the "WHAT 
cemmand instead of "UNLINE» SENDANG™ or VFONLINEs RECCIVING"™. 


An explicit "ONLINE™ or “HESTASRT" command is required to 
remestablish communications unless the remote SYCOY¥ orcecgram has 
just gone to odeginninygrofejod or the remote operator entered 
either an "ONLINE™ or *"RESTART™ command to the SYCOU™ crejram. 


Zleges 23e 
A srobies Tl bel corrected in the SYCOM program which caused 
the message CONNECT OENIED» PROBABLY NO SERVER PROGRAM® to de 


displayed in response to a “CONNECT™ command when a server 
program dtd exist. 


The “LIST SCHEDULE" command disoclays ali the files which are 
queued to de transferred. | 


2ieZeils 
The SYCOM program no Pca halts with "FATAL ERROR 3440G000"-. 


2deZel2e | | ae | 
The number of fetches ie Ager eieabaved in resporse to the “WHAT 
coamand. | | | a 


The sYCO™ program now hos sonds to a "CONNECT" command with the 
following connect Feely | 


CONNECT LNITIATED re | terminal number>] <station receive 


and transa@it addres ses> 
CONNECT COMPLETED 


21s Ze14e 
The SYcOM program now uses YPRITOCGL TYPE 2" wher running tn 
conjunction with the SMCS program. If a user togs onto the SMCS” 


program with a <usercode>/<password> and then enters a “PASS 
SYCOM <text>”™ to the SMCS programs the usercode/password pair is 
automatically appended to each file name specified in a "PUT" or 
*FETCH™ casnanee 


For omnes: if a user Logs oanto the SMCS orcgram with the 
following command: | | ; 


US USER/ JOHN 
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then a "PASS SYCUM PUT A™ or "PASS SYCGM FETCH A™ 15 actuatty 4 
put or fetch of file "CUSERI/SA%>» respectively. Alsc» if the 
default packwid for "USEK/JCHN"™ 13 "USERPACK™» ther a "PUT" or 
WFETCH™ of file "A" tis PUT or FETCH of file "USERPACK/SCUSERISA™. 


21 2 4 2. 15 ® 

8 ane —_ 

The SYCOM program now notifies all users “sitgrec cn" to the SYCO™M 
program when the remote SYC2M program is terninating with the 
following message: 


SieZelbde 

Entering the “STOP™ command now notifies all users signed onto 
the SYCOM program that the SYCGM projram 15s stopping with the 
following message? 


’sTop" IN PROGRESS. 


fileZelfs 
Alt SYCUM program messages to a terminal now clear to the end of 
each message Linee This makes reading the Line easier. 


212221382 | 
The use of special characters in passwords 15 now allowed» except 
for the comma "»” and right parenthesis %)" characterse 


Sleagelis 2, | 
The "US" command now removes the current usercode/password pair 
without detaching the station. The station is cisconrected 1f it 
was previously connected. | 


Z42e22232 
For better er ere cf the SYCOM programs filenames are 
inciuded in SYCOM's. control Mess agese 


ed ~eZle ; 
The SYCOM program now checks for the. presence of a file when the - 
"PUT" or "FETCH" command is entered» rather than waiting untit 
the put or fetch request comes to the top of the put schedule. 
This helps to insure correct spelling of the filenare. 


b1si22Ze 

The SYCOM program now displays the reason for a denial of a 
™CONNECT*™. j$If the message "NOL ADDRESS ERROR™ Ys displayed» 
there is no receiving address in the remote network centroller to 
handle the connection. That iss» no matching NOL address was 
found for the user mstation'ts transawit address at the Local system 
in the list of serverwstation receiving addresses at the remote 
system. If the message "STATION NCT ENABLED» PROSABLY NO SERVER 
PROGRAM" is displayed» there was no SMCS program ir the remote. 
system to handle the connect. 
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Piss2 ys. 
The “VALUE STACK" size for the SYCOH program has beer reduced to 
BG»CiG bits from 140909 bits. 


gietelhse 

if the SYCOM program has been executed or nodified such that the 
multicrfilertid for the PARAMETERS file is specified» the SYCOM 
program uses that multirfileria for alt of the workxfites of the 


SYCOM programe This attows users to run rnultipl2 copies of the 
SYCOM program with the same code file name. ir doings so» SYCOH 


users can take advantage cf the MCP rementrant cede capability 
which allows programs with the same code file name tc share the 
Same code segments In memcry. 


The dGefauit sieistivesie for the "PARAMETERS" £file is 
"<sycom>/PARAME TERS". 


The: Howouuus, ae: Sone examolas of changing the multirtfiletid at 
execution time using the file ecusting MCP cacrability: 


EXECUTE SYCOM FILE PARAMETERS NAME SYCOM.SL/PARAMETERS; 
EXECUTE SYCOM FILE PARAMETERS NAME (USER) /PARAMETERSS 
EXECUTE SYCOM FILE PARAMETERS NAME SYCOMs2/PARAMETERS: 


The following is an example of modifying the SYCQM program's 
WPARAMETERS™ files | | 


MODIFY SYCOM Fl (PARAMETERS NAME CUSERD/ PARAMETERS? 


2be2a25e : | 2 = 
The quote ¢") characters are now incluced arcund the 
muiticrfile"id portion of a filename when a4 remove or change 
command 1s zipped to the MCP. This prevents a problem where the 
MCP commands PRE <multiefiletid>/OLCTRACE* and "CH 
<mutcirtfitertid>/TRACE <multicfilertid>/OLOTRACE* would get the MCP 
error message "ZIPPED AN $INVALID CONTROL CARD*™ immediately 
following seginning of jos’ cof the .SYCOM program. This probien 
occurs if the name of the SYCCM orogram or the multifile-id 
portion of the SYCOM parameters file ts changed to contain 
special characters or lower case letters. 


g1222262 

Messages to a remote terminal are no tonger truncated if the Line 
overflows and the scrotl option is set for the terninal. 

ZilezeZfe a an: oan 

The message "MESSAGE SENT TO REMOTE SPO" 183 no toncer displayed. 
on the system GOT when the SYCOM orogram is running in RJE mode 
and logged onto a host system. This message is only valid when 
not in RJE mode. 


an a4 


212222382 
Printer and punch files are now actually openeca wher the "PRINTER 
OPEN @ <printer filenanme>*™ or “PUNCH OPEN = <punch filename>” 
message 315 dispiayed on the system's OCT. Also» the number of 
lines printed for printer fites and cards punched fer punch files 
1s displayed when the file is closed. 


The message "INVALID CARRIAGE CONTRUL CHARACTER = a@<character>a" 
1s displayed on the system’s OOT oy the SYCOM progran when an 


Incorrect carriage control character i585 receivedce The SYCOM 
program replaces the incorrect character with a bBtank character 
ard continues processing. A Slank carriage control character is 


Ignored by the SYCU™M progran. 


s2222 
The "PROGRAM POINTER STACK SIZE" tn the sYCOM progras has deen 
Increased from 25 to 5) entries. 


£i2Ze2e3ls 
The SYCUO™ program now updates the following fields in the disk 
file header when transferring a file. 


VERSION_DATE 
VERSION _TIME 
PROTECTION 
PROTECTION _I0 
CREATE_TIME 


Updating these fields makes. transferring DMS files pesstole. 
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2221. Introductions 
; 


he Mark S$e%93 release cf DC/AUDIT contains no new changes. 


£iei2 Temporary Qocument3tigns 


Lizsels 

When Logging a WReAPOL Cwrite autopott) operaticn» a slash (/) 15 
included in the autcooll string. The stash indicates where the 
autopoll operation oeueGtae The address is itimmeciatety to the 
left of stashe. | 


If no stash is printed the operation comoleted on the Last 
address printed. | 


The address option 1s now set dy default. 
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2321. Introduction. 


The Remote Display CRD) program provides a methea for an operator 
of a remote display terminal to oitain tinfermation adout the 
system environmente This information includes file and orogqranm 
attributes and the current system statuse Many cf the inquiry 
commands in the RO program provide the sawe (and ir s0mne cases 
more) information as do their corresoondirg MCP ccmmands. The 
Mark $23 release of tha slvte aD program includes enhancements 
and corrections to outstandinj3 problems reporteda ir the Nark 84% 
release of the RD program. Taese enharcaments include 1) the 
tmplementing the "CP" (compute) coamand» 2) the ability to use a 
partialerfilewid for the "PDO"™>» "KA%™» "%3F"™» and "DF™ cemmands» 3) 
tmplementing Program Switch 3 which assigns the maxigun nunber of 
jobs that can be displayed in the program-taote» 4) imptemnenting 
the “SUAMMARY™ option to the "KA* command which causes the RD 
program to display statistics about a family of files» and 5) the 
RO program now uses "PRETOCCLE TYPE 2" ss defined by the SMCS.» 


Compiete documentations  $aincluding these enhancements» is 
avatladle in the form of a printer dackup file labeled 
DOCUMENT/RD.«. The corrections to outstandirg precolems are 


documented in the following paragraphs. 


23225 En ha ancenent 
2j2Zels. 


The "MIX" command can frow De adbreviated as "MX". 


The "R® command can no Longer pe usede 


The ae tyes m4 Xx: eee summary has two new columns. They are 
"M" C@edia)d) and "OVLY"™. The "M" column displays a "1" if the joo 
1S Yn memory and a "6G" 1f the job is "rolled out". The "UVLY* 


coluan displays the seetes number of code and data cavertays for 
the j ode Sas | | 7 | 
Li2icZe2 an | 

The “"TEACH™ command can now De abbreviated as "TE™ and "TEA". 
Entering "TEACH SWITCHES or TEACH SW displays RO"%s current switch 
settings and the meaning of each switch. 


2202235 nF 

The RD program's “"RNT™ remote file now uses "PROTOCOL TYPE 2” as 
defined by SMCS. This provides the RO program with the usercodes 
passwords» usercode index» and station signal character for a user. 
at a station when the user passes input to the RD program or the 
user is logged on to the RD program with a usercode/passworde 


1 26 


Any "PASS" input through the S4CS to the RO orcoram causes the RD 
program to apply the usercode/password to file names unless the 
asterisk "7*" character convention 1s used to override the 
usercodes This means that if a user is “Logged on™ to the SHCS>» 
a “PASS RD™ of any directory*s2arch commands such as "PO"%s» “"KA"» 
"PEF™, or "OF" for a singletnane file that does rot have the 
user's usercode as its muditimfiletid must be preceded with an 
asterisk "“*" character. For exaapler entering “PASS RO PD MCPLII* 
causes the &D program to search the disk directcry for a file 
Labelled "“Cusercodedy/MCPII"™ and antertrng “PASS 80 PD *MEPII* 
causes the ROB pregram to search the system disk directory for 
"MCPII".. If the usercode has a default user packwide the RD 
program searches that disk for the file name. 


Print files created by the "PRT* command Have the usercode name 
apptied to the print file name This can be overricdcdan by using 
the "NAME" option in the "PRT" command. The folltcwing exanmcles 
tilustrate the use of the “PRTI™ conmand. 


PRT NAME A/B CIf "logged on™ to the SNCS ard 
the usercode 1s not privileged» 
then a security error rasults.) 


PRT NAME #A (Print file name is 7A.) 


PRT NAME A (Print file name is "A™ if not 
ae “Logged an™ to the SMCS. Print 
 ftle name is "Cusercoded/A™ if 
ae “Logged on™ to ‘the SMCS.) 


The "SIGNAL™ or "SIG" commana ane the use of prograr switches 4 
and 5 for initialization of a networketwide signal character have 
been replaced by the use of the passing station's current signal 
character as provided by the SMCS. The SMCS supplied signal 
character is used oy the 20 program in the gereration of 
successive "PASS" (Teput continuation messagese 


2ae2eh4e pea _ ; 
The "FN*™ command now. Lists the eelseive file number eee oe at. 
zero for all the internal file names in a program. Also» "PNY 


and "PQ" can be entered from the Operator Disptay Terminat (ODT) 
as ACCEPT input while the RbOb program 1s runrirg tn data 
communication eer CSHITCH: QO = Gg). 


Examples: 


<RD program eres a DMPALL. 
<RD program number>AXPa 


L2l 


ga22032 | 
A PASS™ of "EYE" or "BRA™ stops the “"UMX" COnline 1x) outpute 
Previcuslys 2 “PASS RO OMX BYE" was required. The "OMX" part 15 


new optional. The following examote illustrates the new syntax: | 


PASS RD OMX PAGE 2 ) {Initiates the ecntine nix) 
: Clater) 
PASS RD SRK or PASS xD BYE (Terminates the ortline mix) 
Si2228s 


Ail dates are now displayed in "MM/DD/YY" fornats» where "MM" 15 
the month» "DD" is the day» and "YY" is the yeare 


2322eFe — sss 

The RD program now includes the "UPDATE" column in the response 
toe the "KA™ command. The “UPLATE colunn displays the Last date 
that a file was updated 45 maintained by the MCF. Also» the 
user"mcount column nas Deen abdreviated to "US" from "USSR 


The "3F LASELS™ command handles doth the Mark &.3 ance 9273 Dackup 
file fornatse. Also» for dumpfiles (8F *DMP/= LARELS)» the 
program name that 18s associated with each dumpfile ts Listed. 


g3ege25e 
The RD program uses a PDETACH“WITH- CLEAR®™ on all station detaches 
except those caused. lit | Sn bey ct "OMX" while "signed or™ to the RD | 
program. | | : | ae 


2Je221G- | a | | | | 
The "US" command to Leg on and log off the RD program now replies. 
with the usercode and program name The fotlewing exanple 


tilustrates the "US" command and its response: 


“Command: US USER/PASS 
Responses CUSER) LOGGED ON TO &O 


2322211. ae | = =. . : 
ee eae (PROTECTED) in the mix table is now updated 
correctly. 


| £b22212 


The "CLS" command with the RD orogran in patcn mode 


CSWITCH G = 1 or 2) causes. the kO program to close its printer | 
file Labelled "LINE". | . | 


£32 alse. 


Fhe problem tn the &O program which caused the errorecus message 
"MESSAGE GTR BUFFERSIZE"™ to ba displayed has been correctede 


5 a 


23egei4e | 
The RO program no tonger halts with "READ QUT OF 2F0UNDS” when 
using the "Pa" command. 


23222132 
The xD program now orcovides the asterisk "™*" character in the 
file name for the "FN" command. 


The RD orogram no longer writes type 15 messages (CUETATH“REPLY)D 
te tne network controtler. 


The <diskx address> and <nunber of sectors> displayed in response 
to the "KC" and "KP" commands are now also disolayed when a user 
TS “signed on” to the ROC progran. 


£3222182 
File names can now be specified with an asterisk in the 
aulticfilerid even when the mnultiwfiterid already has ten 


character se 


23222192 _ | | 
The "FN'™>s, OF 7%, KOs and "KP" commancs now respond with 
*"<complete file name> NOT ON CISK™ if the file is not fecund. 

, St 
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24ele Introductions 

The Mark 9.0 release of the CsMS/INQUTIRY progran contains 
ennancenents to the GPTIUNS and PRINTER statements» along with 
changes designed to increase tnroughput and performarce. 


The DMS/INGUIRY control files (C<catadase ramero/INescTL.) are 
compatidie Setween the Mark dec release anc Mark Yeu release. 


Cha gele 

The OMS/INQUIRY progran printer fite can now 5¢€ clesed ay the 
uUSePre Specifying PAINTER RELEASE Cadbreaviated 2? %) causes the 
print file to be closed» if it is open. if the fila is a Dackup 


print filer the otackup print file 1s relaased. 
txampless 


PRINTER RELEASE 


P oR 
24s legs 
The DMS/INIUIRY output can now ce directed tc the tarminal and 
printer simultaneously. secause of this feature» the JPTIONS 


TERMINAL and OPTIONS PRINTER statements have ceen nodifieds as 
follows: 


OPTIONS: === “TEs INAL. shoes eee ser seen se sseee =| 


1 - bo 
I- PRINTER -"1 0 t+ = t3- TRUE <1 


Specifying TRUE causes outout to be directed to the devices 
specifying FALSE suopresses the output to the devicee If TRUE or 
FALSE is not specified» TRUE is assumed. Specifying FALSE on one 
device causes the OMS/INQUIRY program to set the other deavice toa 
TRUE» if not aiready TRUE. 


Examples: 


DPTIONS TERMINAL = TRUE 
CPTIONS PRINTER = FALSE 
GP =F | 


When the output is to both cevices simultaneously» the terminal 
attributes (page width» form3t) override the crinter attridutes 
for the printer. 
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25e1- Introguction- 


The Mark 5-3 release cf the SGKT srograms consist of SORT» the 
SORT intrinsic programs CSGRT/YSORT» SORT/GSGRT» SURT/STAPESORTo | 
and SORT/MERGED» and the SUAT/UTILITY progran. 


With the SORT/UTILITY orogram,» records in the input file can be 
selectively oprocessede including or excluding recerds from sort 
processing depending on specified conditions. 


The sORT/UTILITY program can oroduce output records whose “format 
and content differs from that of the input records. Fields ina 
record can de selectively rearranged or exclucec. Literals can 
be inserteaq into chosen positions in the output records. 
Selected fields can be Summed to srovide user processing during 
the sort rune 


MulLtipi2 record formats can 3¢ specified within a single otitput 
file. User spectfied criteria determine the arrargement and 
selection of fields in a records and thera can be several sets of 
criteria for each cutput file. 


The SGRT/UTILITY progran is functionaily comnatiole with the [34 
$OS0R7T programe Specifications may oe given in free form format» 
as in the SORT programs or itn the fixeo field fermat cf s050RT. 


Temporary documentation descriding the operatior and functions of 
SORT/UTILITY and SORT ts included in a printer backup file named 
GDOCUMENT/SORT supplied as a supplement to these System Notes. 


2selele | 

When an input record is declared as DEFAULT» SCRT will not check 
for out of bounds keys. The MCP SORT INTERFACE will handte this 
taske 


2£2 EFURTRAN Z7 


26else Introductions 


inctuded in the Mark $.0 realease of the slits Systen Software 15. 
the initial release of the 81432 %$FORTRAN 77 compiter anda 
interpreter. The new FGRTRAN system will run cr atl £123%3 
computers except the 31825» 3183¢ ard 31716 series of connuters 
Since these machines do not have cache or contrcl memory. 


The FORTRAN 77 software compiles and executes prograns written in 
American National Standard Programming Language FURTRAN» ANSI 
XZe97*1LI7 Ge Thts new definition of FORTRAN» known as FORTRAN 77>» 
1s not a rewrite of the previous FORTRAN» FORTRAN 65» odut is an 
entirely new FORTRAN systeae Although this 1s the case» the 
syntax of FORTRAN 77 is still somewhat similar to FERTRAN 56.4 A 
brief description of the major new features of FORTKAN (77 
follows. : 


le A data type of type CHARACTER 15 implemented as well as 
several string manipulation capabilities» such as 
concatenations sudstring extraction and assignments» and 
string scanninge 


€e More flexiole controt structures are availathle. Included 
are iF statements that give the option cf naving more 
than one executaodle statement after the relational 
expressions Structured dO0~-Locose and . wulticle entry 
points in a subroutine. 


Ze DBDowloops now attow increments of either positive or 
negative values. DU"lLoocps also detect jumos tnto the 
range of the loop and flag them as an error. 


4e Additionat file attributes can ba soecified. 


5e Conversion of data from one type to ancther can now De 
easily accomplished through the use of internal files. 


The FORTRAN 77 software is 3 program preduct which way be ordered 
through the local Burroughs office. Gocumentation for FORTRAN 77 
1s available with the FCRTRAN 77 #=.software in the form of a. 
printer oackup file tapeled COCUMENT/FCRTRAN/7. 


2Eeis Temporary Documentation. 


The following statements are implemented but the printer backup 
file Labeled DOCUMENT/FORTRAN77 does not reflect this facte 


L£E2e3e1s 
DATE 8S an intrinsic functicn ahich returns the ctrreant date in 
ary one of four specifiatle formats. The form of the DATE 


Intrinsic followse 

DATE C format) 

Format nay de any of the following: 

"MMOCYY” 

wy YaMpDoO" 

"yyYDoo" 

"HHMMSS” Ctime of day) 
efeisls are 
TIME is an intrinsic function which returrs the time function 
specified dy two parameterse The form of the TIME tntrinsic 
fcollowse | 


TIME Cfunctionsunits) 


Function may de any of the following: 


"DAY * | Ctime of day) 

PELAPSED™ Celapsed time of the program) 

"PROCESSOR Ctotal precessor time for the poregqram) 

SLs" C€total [70 time for the program) 
Units 315 a unitrof“time scecification which scecifies the units 
in which the time 1s to be printed. For 2xampler .1 specifies 
that the time 1S to be orinted in terths cf secondse 


le specifies that the tine 1s to be printed in secords. 

£Eeie232 | | - 

The CALL ZIP statement zips a string of characters toa the MCP. 

The syntax of the CALL ZiP statement is 45 faolicws: 
CALL ZIiPCstring) 


String is any control string valid to the MCP. 
Example: | 


CALL ZIPC"CO PROG FORTRAN7T73F1 CARDS NAM PROGL DSK OEFs") 


823242 
The CALL CUMP statement causes a dumpfile to be produced. After 
the aqumpfile nas been produced» execution continues with the 


statement following the CALL DUMP statement. Prooer form: 


CALL OUMP 
£Eeiel2 ; : ; 
The CALL EXIT statement causes termination cf the oregran as 1f a 
STOP statement were executed. Proper forn: 


CALL EXIT 


2f£2i262 
The CALL CV¥ERFL statement enables programnatic recevery when an 
exponent overflow or underfiow has occurred. The form of the 


CALL OVERFL statement foltiows. 
CALL QOVERFLCTD) 


Execution of the CALL GVERFL statament sets I to 2 i 1f an 
exponent overflow has. occurred in ary variable sirce the Last 


CALL OVERFL statement. I ts set to a 2 if neither an exponent 
overflow nor underflow. nas occurred since the Last CALL QVERFL 
statemente I ts set to 3 31f an exponent underflow has occurred 
In any vartaole since the tast CALL ODVERFL statement. 

2Ee3els 


FORTRANT7/ANALYZER 1s a program which analyzes either a FORTRAN 
{7 code files a FORTRAN 77 intermediate code file» cr Bene 


A cede file is generated from the compile step and ae used for 
the execution of the programe it contains tnformation concerning 
the program parameter block» file parameter block» code segment. 
dictionarys data page dicticnary» data sages» laycut tadle» and 
the code to be executed. | 


An intermediate code file is generated by the coa#piler centret 
ecard SAVEICM. This file consists of a directory ard one or more 
intermediate code modules CIC). The directory records the 
number of ICMs» their names» and their locations in the file. 


An ICM consists of a header describing information certinent to 
the module» as well as the address and size information of the 
following parts of the module: 


Data Page Dictionary Cif any) 

File Parameter slock Cif any) 

Code (subroutines function» or main orogram) 

Reference Table Clocations withir the code where. 
subroutines» functicnss and common Dilecks are 
referenced) | 

Dummy Argument Information Table Cif any) 

Initialized Data Pages 


The following entities generate an intermeciate ccde module 
CICM): the mnain program» a subdroutines a furcttion»s an 
initialized common blocks» and one or more FILE declaratianse ~ 

To execute the program ara have the output file displayed on a 
remote terminal» use the following statemant: | 


EX FGRTRAN77/ANALYZERSFILE LINE REMOTE 


Ta execute the program so that the output file is rrinted» use 
the foliowing statement: . 


EX FORTRAN7/7/ANALYZERSSW 1L=1> 


The user provides input options via the DISPLAY/ACCEPT facility. 
in response to the command promot: FNTCR Filet NAME» © the user 
enters the following statement: 


<jod#>AX <code file name or ICM file name> 


The program verifies the file nane and either aisrlays an error. 
message» or responds with the command promot ENTER tPTiIONS» NULL 
TO STOP» OR HELP. [Ff the user enters KelrP» the pregram requests 
the type of file (code or [C¥) and displays a tist of appropriate 
options according to the file typ2 the user has indicated. These 
options determine the part of the cede file or ICM to be 
analyzede The list of options displayed for a code file follows. 


PPS a 3 Program Parameter slock 
FP3 Frle Parameter 3tock 
SD Code Segment Cictionary 
56. Data Page Dictionary _ - 3 
DP (page nunder ] Data Page Cone or all» dafault is ait) 
LT | Layout tadle | 
CODE Cnumder» name | | 
er ALLI | 
ALL | | ALL of the above 
GET file name bet another file 


For an ICM. trles the list of options sreotavied foll cuss 


ALL | | Directory and ali ICMs 
DIRECTORY | Directory listing 

an ICM name ICM name to Ge analyzed 
HEADER i TCM Header | 

oD TCM Data Page Dictionary 
FPS | | TCM Fite Parameter 24cck 
CODE : [CM Code 

REF ICM Reference Table 

DAT | TCM Dummy Argument Information 
DP : | {CM Data Pages 

GET file name Get another file 


petions. are entered individually or serially. | If entered > 
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serially» they are sesarated by commas and/or blanks. 


If an ICM file is specified with no other qualifying cptions» the 
default 1s an analysis of the entire ICM. 


To terminate the programs 4a null entry is transmittea, 
Program switch 1 determines whether or not page skipping is used 
in the printer Listinge Nhen set to zeroes page skipoing is 
employeds when set to one» it 1s Suppressed. 
The following error messages may occure 
"<seaqment name> : INVALIO SEGMENT WAME. TRY AGAIN" 
"<option name> =: INVALID JPTION. TRY AGAIN.” 
"<page number> 3: PAGE NUMBER OUT OCF BOUND. TRY AGAIN.” 
"<segment nunber> = SEGMcCNT UUT UF 30UND. TRY AGAIN." 
"<token entered> = EZThRER INVALID JPTIUN 
OK INVALID ICM NAME 
OR MORE THAN GONE ICM SPECIFIEO. 
"FILE MISSING 3 <fitle name ee 


"INVALID FILE NAME" 


"FORTRAN? 7 LCM JR CUDE FILE REQUIRED* 


£b~2 328s 

Many users will need to make a determiraticn concerning 
conversion from 1966 FURTRAN to FORTRAN 77. Tce help ian this 
determinations this section describes some of the problens that 


may be encountered tn such a conversions 


1. String data can onty Ce assigred to variables of type 


CHARACTER» not to numeric types. If a pregram uses the 


1965 FORTRAN character maniculation facilities 
extensively » a total rewrite witht probably be tn orders 
ALL numeric itemss which contain character datas wil 


need to Bbe changed te type CHARACTER. ETOH and PUTCH no 
Longer work so these routines wilt have to be replaced. 


ce CHARACTER and numeric data cannot reside ir the same 
COMMON block nor can they be equivalenced. 


3< Length specifier *<integer> works only for type CHARACTER 
Ceege KEAL *8 no tionger works). 7 | 


4. Maximum record length is reduced from 2647 to 1923.6 


4 
? 


Ge 


Lie 


12 


13-6. 


14. 
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£39 


Word format has changed so any variables initialized in a 
DATA statement with Z need to he chanaece. In many cases 
this change will onty de the removal cf thea first hex. 
character (4 pits) but other changes may recuire shifting 
of the data. The documentation to be released with 
FORTRAN 77 tells of the new word formatse 


The DATA statement must cone after alt srecificaticn 
statements. 1966 FORTRAN altowed flexible placement of 


the DATA statemente 


In 1966 FORTRAN a Df Loop is always executed once. To 
produce the same result in FIURTRAN 77» CO loops should be 
changed tn the following manner: 


DG label v=el» eg» e3 ====> OC tabel v=elr MAXCe2xel)s» a3 


A jump into the oody cf a SU tocp is a FORTRAN 77 
compiletime error. : 


The DO iteration count cannot De changed within the Loobde 
An attempt to change the OVC variable is syntaxed at 
compile "time. Attempts to change cther variables that 
the 00 Loop may depend on are allowed. | 


For random I/0 operations record number syrtax changes 
trom <unit™no>=<rec™no> to <unit™no>*<rec*no>» i220 the. 
equals sign must now D2 an apostrophe. C19€6 FORTRAN. 
allowed either the "=" or the "™'"). | 


Free-format I[/ds% as inplemented in the Mark 7.229 release 
of 1966 FARTRKAN cannot be used tin FORTRAN 77. 


FORTRAN 77 requires a comma between specifiers in a 
FORMAT statements. 1966 FORTRAN allowed comma omissions 


H strings are only valid in FORMAT statements. To 


convert to FORTRAN 77>» delete the H ard the integer 
preceding its» if ary» and surround the string with 
quotation marks or apostrophes. | 


The capabilities available through use of the DATA and 
ERR action specifiers have been cordined into one 
specifter in FORTRAN 77: the ERR specifiers Use of DATA 


will cause a compile~time errore 


The NAMELIST statement will not be in the Mark 920° 
weleasee Although NAMELIST will cotpile without a syntax. 
errors it will not execute. 


The FILE statenent has deen changed extensively. Refer 


to the FORTRAN 77 documentation for the exact syntax. 


17. 


cce 


C50 


25. 
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Edit descriptor usage 15 more rigid in FURTRAN 77 than in 
1566 FORTRAN. For example» INTEGER type data can no, 
Longer be written with an F edit descriptcr. Refer to 
the FORTRAN 77 docurentation fer tne exact 
Specifications. 


Carriage control character """ (triple space) is not in 
FCRTRAN 77. 


The CHANGE statement is not tn FURTRAN 77. 

The LOCK statement has not been ttmolemerted Dut the 
FORTRAN 77 CLOSE statement has a KEEP attribute availabdle 
to the usere | 

The PURGE statement 15 not tn FORTRAN 77. 

CALL SSWICH is not In FORTRAN 77e 


All program units that are compiled with the $8S5AVEICH 
compiiar control option are saved under one name: 


eSSRTNe In order to save [CAs under a different namer a2. 


file name should be used with s5AVEICM Ceege. SSAVETCM 
"MY ICM)... if a file name Is not used» each sudsequent | 
compile will remove the file .S&SRIN created from a, 
previous. compile. 


The fotlowing compiler  controt images were not 


| imp Lemented: 


scD 
CODE 
ERRORTRACE 
INITIAL 
LIBRARY 
LIBRARYPACK 
 NEWINTRINSTIC 
PROFILES 
SINGLE 
TRACEF 
_XREF | 


The fottlowing compiler controt images were inplemented 
with changes: 7 


CONTROL Cnow LISTS) 7 | 
INTERPPACK Cnow INTERPRETER> ertire rame can be 
specified) | 
INTRINPACK Cnow INTRINSICS? entire name can De 
| specified) 
RANGE C"HANGE™ deleted) 
SEGERR | Cnow SEOQCHECK) 


260 


Zte 


More completa 
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Information concerning comriler controt © 
images as imptementea in FURTRAN 77 is available in the. 
FORTRAN 77 documentation. 


The following intrinsic functions were not imoplementede. 


ALGAMA 
COTAN 
DCOTAN 
O€ RF 
DERFC 
DEFLOAT 
DG AMMA 
DLGAMA 
ERF 
ERFC 
HF IX 
LGAMMA 


The following intrinsic functions were implemented 
a differant namee 


under 


4 


Function New Name 


ARSIN 
BARCOS 
DARSIN 
Lac 
LOG619 
M TN 


282 SPO is now OUT. 


2@9e ASterisk Cr) 


CC’). 


ACES 
ASIN 
DACOS 
DASIN 
AL GS 
ALOG1O 
MAX 
MING 


in an alternate return 1S now an ampersand _ 


A suggested method of conversion is toa 


3G. Columns 1°75 of a continuation card must contain blankse 


Arrays used in EwUIVALENCE statements must have the same 
nuaber of dimensions 45 were declared. : - 


A simple I/0 list is prohibited from being enclosed in. 
parentheses. | ~~ | 


writing to 4 tape file after an endfi te recerd has been 


written is prohicitede 


changed. Refer to “Temporary. 
for the correct ans 


The TIME intrinsic has. 
Decumentation 264342. 
1966. 


compile a smalt 


FORTRAN program under FORTRAN 77 to become familiar with the 
cempile-time errors and to then convert larger programs as_ the 
user sees fite | 
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Zing CUBOLTS 


gfels Introduction.» 


Included in the Mark 9eu release of the 31°33 System Software is 
the initial retease of the 330L74 compiter and Interpreter. 
cOBCL74 will run on atl bilit® computers except the § 18255 61836. 
ard 61710 series of computers since these nachines de not have 
cache or “control memory. > 


The CO80L74 . software compiles and executes programs written in 
COBOL in accordance with the American Nationai Standard Institute 
CANSids Xie Z2571LF7 4 


ée 
New features included in CO8CL74 are as follows. 


le New file organizations. — ‘There are row 3 file. 
organizations: Sequential» xkelatives» and Irdexed. 


Ze Fibe Attributes. File Attrioutes provide the capadility 
for defining» monitoringes or changing properties or 
attriocutes of a file. | 3 | 


3e Indexed files are now nanaged by the MCP» provide greatly 
¥mproved performance over (CO8BL68 tndexec files» and 
function ain a manner similar to the  £ OMSIfT Index. 
Sequential Structures. Records may now oe AdDed or 
BELETEd. without invoking a sort intrinsice Duplicates. 
may optionaltiy be allowed for alternate keyse. oa 


4e Linage clause for Sequentiat files. The LINAGE clause 
provides a means for specifyirg the pagesizes margins» 
and footing of a logical page. ; 


Se Interprogras communication is now possiole through the 
use of the "CALL™ verb. A program may "CALL*® anothers 
pass parameters and share datas | | | 


be The "INSPECT" verb provides the capability of scanning. 
and replacing text» counting occurrences of a character 
or group of characters» and specifying the portion of the 
text on which to perform the function. | 


ve The "STRING" verb. Partial or complete cortents of 2 or 
more data items can be concatenated into 1 by the use of 
the “STRING™ verde | 


8 The "UNSTRING” verb. Taking contiquous data in 1 data 
— - ¥tem and moving it to multiple receiving fields is also 
possible py the use cf the *TUNSTRING®* verb. 


9e Standard Debugging facilities. Jsers can now specify the 
conditions under which data items or procedures are to be. 
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monitorea during the execution of the prograre 


lve Standard Data Communications. Through the use of the. 
"SEND”™ and "RECEIVE" verds information can te obtained as 
to station nanes length of messages hew many. stations to 
De addressed» and error informatione 


lie GMS II is avaitable in CO3CL74. 


12. “3XREF™ is now part of the compiler ard will generate a 
orogram cross reference at compile tine without requiring 
additional operator interventione 


1l15e- Use of the option “f80MiT”" provides the capanvility cf 
conditional inclusion cr exclusion of scurce Imagese. 


L4e Dump Analyzer for COQB8OQL74 prints. the variable name in 
addition to the vatus of the Gare itemte There is also 
Improved error detections | 


154 Table Handling nae improved with individual bounds 
checking on suoscripts and the capability of variable 
length tables. | 


Two new utilities have been introduced in this Mark 920 release 
for CoOBOL74.. They are SYSTEM/ISsMAINT for irdex files and 
SYSTEM/FILce«iNiIT for relative files. Documentation for 
SYSTEM/ISsMAINT and SYSTEM/FILS.INIT is available in the form of 

a printer backup file taoeled OOCUMENT/UTILITY.. 


The COd0L74 compiler is a program product which may oe ecrdered 

through the tlocal Burroughs offices. Documentation for the 

COQ3GL74 compiler is available with the COSGL74 software in the 
form of 2 printer backup file Labeled BOCUMENT/COBOL7 4. 


21232. Tesporary Documentations 


‘Zia 3ets. Indexed File Naming Conventions 


For ani index File» if a file is defined as "FD <file name> oon” 
and no "VALUE OF TITLE «02" clause is specified» then the 
external file names of the associated files will be as follows: 


"<file name>" 
"\o<fitle name>" | 
"C1l<fite name>" eas "99<file name>” 


Data file 
ALL. —e files 


noun 


if pies is. an Veytenwal file name defined threugh the "VALUE OF 
TITLE" ts “<familyrid>/<filetid> on <disk pack*id>" clause and 
Bas 1d> is not. blank then the external file ids are: | 


"edprtid>/<famitytid>/<filetid>" 
"<dprid>/<familywid>/2¢<filetid>* 
"edprid>/efamilyrido/olctilerid>™ through 


 Ckuster fite 
Data file 
ALL key files 


hom Hn 


136 


"<dprid>/<fanilyrid>/99<filesiaq>* 
If <filerid> is btank then the naming convention aprlies to the 


<familycid>. 


Cluster file 
Bata file 
All key files 


"<dpcid>/<family-id>/" 
"<dpr1id>/%¢<familyrid>/* 
"<dowriar-/tl<famtly7id>/”" ea 
eee een ae Ree 


ow 


The MCP disallows file aquation of Indexed Files. To change the 
name of an Indexed File refer to SYSFEM/IS.MAINT in the Utilities 
Section cf tne System Notes. 
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282i. Introductions 


Interactive 3ASIC CIGASIC) with be avattiabdle in the Mark 9-0 
releases aithouah not. in the initial raetease. IBASTC will run on 
ali BlG2C computers except the 2912255 81330 and 217172 series of 
computers since these machines are norcacher noncortrol memory 
machinese | | 


BASIC» an acronym for 8eginners Allvwpurpose Symbotic irstruction 
Codes was initially developed at Dartmouth College. The American 
National Standards Institute CANS!) has developed a standard “(for 
BASIC using the originat Dartmouth 23ASIC clus acditional features 
as. dictated oy the industry. 3urroughs has implemented the GASIC 
Language according to the American National Standard for 3ASIC 
developed oy ANSI. 


BASIC is a problemmoriented tanguage designed fer a wide range cf 
applications and nay be easily applied to doth 2ducational and 
engineering/scientific processing taskse The BASIC Language is 
designed for use beth by individuals whe have Little previous 
knowledge of computers as well as individuals with considerable 
programming experiences A distinct advantage of BASIC is that 
tts rules of form and grammar are easily learned. 3urroughs 
 TSASIC is especially suited for the Learning process since 
“response to errors. is” nearly immediate for many of the errors 
common to novice pre or Semone | 


Senroushs TaASIC. 1s. bepvoeented in a conversational mode: the 
user enters sASIC statements and interactive commands through a 
terminal to the IBASIC system whereupon ISASIC processes the 
input and responds with either the output for the commands a 


message informing the user of any syntax errorss or a request for 
more ynpute , 


The LBASIC orogram: Greduit fs. scheduled Pree release Sneeaniaate ly 
one. quarter after the initial release of the Mark 9-2) system 
software. The documentation wilt be availadle with the retease 
of the TBASIC pre ee acamiead 
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MCPII Patch #1 

Insures that the file name of a ANSI 74 CO3GL ISAM file can not 
be changed prior to execution. , 

MCPII Patch a&2 

Corrects a problem which caused the MCP te halt or write 
cerrupted data when writing Delayed nandon File bufferse 

MCPIi #3 


The ANSI 74 COSOL file attrivute "“FLEXISLE™ has beer Cisabled. 


DMS/KEQRGeWRIT #1 


Corrects the proolem where the reorganization staterert "GENERATE 
<datasset> CRBOERED BY <set>" caused the OMS/REGRG WRIT. pregran to 
Seen aes with "ATTEMPT TC READ OUTPUT ONLY FILE". 
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